Map countries to currencies

This guide walks you through setting up country → currency localisation from scratch, so guests from each country automatically see prices in their own currency. It takes a few minutes.

1. Enable the feature

1. Navigate to Addons → GeoSync Pro → Currency.
2. Under Currency Localisation, toggle Enable Currency Localisation to on.
3. This activates automatic geolocation and currency selection for guest visitors. Logged-in users continue using their profile currency.

2. Pick a default currency

Set Default Currency. This is the fallback GeoSync Pro uses when a visitor's country can't be detected or has no mapping — so a price is always shown. Choose the currency most of your unmapped visitors should see.

3. Add your country mappings

In the Country-to-Currency Mappings table, click Add Mapping for each rule. For every row:

• Country Code — a two-letter ISO alpha-2 code (the standard two-letter country code), for example IN for India, GB for the United Kingdom, or JP for Japan.
• Currency — the currency guests from that country should see.

The EU rule

Rather than adding all 27 European Union countries one by one, add a single row with the country code EU and map it to one currency (usually EUR). This EU rule applies to every EU member state at once.

4. Make sure the currencies exist in WHMCS

Mapped currencies must be configured and active in WHMCS:

• Verify active currencies under Setup → Payments → Currencies.
• Check the Active WHMCS currencies table on the Currency tab for quick reference.
• Add any missing currencies before mapping.

Missing currency = no switch

If a mapped currency doesn't exist or isn't active in WHMCS, GeoSync Pro can't switch to it and falls back to your default currency.

5. Test from a public IP

1. Open your client area in an incognito window from a public internet connection.
2. Verify prices display in the currency assigned to your location.
3. Use a VPN to simulate visits from different mapped countries.

Localhost and private IP ranges (127.0.0.1, 192.168.x.x) cannot be geolocated and always fall back to your Default Currency.

Next steps

• Configuration — the full settings reference for the Currency tab.
• Currency localisation — how detection and mapping work behind the scenes.
• Hide the currency switcher — stop guests from overriding the detected currency.