Geolocation for Currencies

This guide explains how to add automatic geolocation to the Currencies extension, allowing your website to detect a visitor’s location and display prices in their local currency by default.

Support

This geolocation feature is currently in Beta and uses a third-party service provided by ipgeolocation.io.

Please note:

  • We are not responsible for the geolocation service.

  • We do not provide support for setting up or troubleshooting this integration.

  • If you run into issues, we recommend contacting ipgeolocation.io directly or reviewing their documentation.

Pricing

The ipgeolocation.io service offers a range of plans based on your website traffic. There is a free tier that allows you to test the service.

Once you're satisfied everything is working correctly, you should upgrade to a paid plan. The entry-level Bronze plan currently costs around $15/month, and supports up to 150,000 geolocation requests (pricing information was correct at the time of writing this guide).

Sign up for an API Key

Before installing geolocation, you will need to sign up for an API key. To do this:

Go to ipgeolocation.io and create an account.

Once logged in, your dashboard will show your unique API key.

Keep this key handy as you’ll need it in the next step.

Installing geolocation

Log into your Squarespace site.

1. Go to the Code Injection page and locate the Footer panel.

2. Locate the following line of code in the Currencies extension:

geoApiUrl: "",

3. Within the quotation marks, add https://api.ipgeolocation.io/ipgeo?apiKey= followed by your unique API key. For example, if your API key is abc123, the line should look like this after editing:

geoApiUrl: "https://api.ipgeolocation.io/ipgeo?apiKey=abc123",

4. Save your changes.

That’s it! The geolocation feature should now be active. New visitors will be shown prices in their local currency based on location. Returning visitors who previously selected a currency will continue to see their saved preference.

Privacy

As third party services may collect personal data, it is your responsibility to review ipgeolocation.io’s privacy policy and update your own privacy policy accordingly to inform visitors about any data collection that is taking place.