---
url: /geosync-pro-whmcs/guides/set-up-currency-mapping.md
description: >-
  A step-by-step guide to enabling GeoSync Pro, choosing a default currency,
  mapping countries with ISO alpha-2 codes and the EU rule, and testing that
  visitors see the right currency.
---

# 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.

::: tip 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.

::: warning 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](/geosync-pro-whmcs/configuration) — the full settings reference for the Currency
  tab.
* [Currency localisation](/geosync-pro-whmcs/features/currency-localisation) — how detection and
  mapping work behind the scenes.
* [Hide the currency switcher](/geosync-pro-whmcs/guides/hide-currency-switcher) — stop guests from
  overriding the detected currency.