Troubleshooting

Something not behaving? Work through the checks below. Each one is quick, and most issues come down to a setting, a missing currency, or testing from the wrong browser window.

Currency isn't switching

If a visitor from another country still sees your default currency, run through this list in order:

1. Is the feature enabled? Open Addons → GeoSync Pro → Currency and confirm Enable Currency Localisation is on.
2. Is your license active? Currency localisation only runs with an active license. Check Addons → GeoSync Pro → Settings → License Information. If it's lapsed, the feature pauses until it's active again.
3. Is there a mapping for that visitor's country? In the Country-to-Currency Mappings table, make sure a row exists for the visitor's ISO 3166-1 alpha-2 country code (the two-letter code, e.g. IN, GB, JP) — or that an EU rule covers them if they're in the EU.
4. Does the mapped currency exist and is it active? The currency you mapped must be present and active under Setup → Payments → Currencies. If it isn't, GeoSync Pro falls back to your Default Currency.
5. Are you testing from a public IP, logged out? Only guest (non-logged-in) visitors on a public IP are localised. Logged-in users always keep their own profile currency, and private/localhost addresses (like 127.0.0.1 or 192.168.x.x) can't be geolocated. Test in a logged-out or incognito window from a normal internet connection.

TIP

Use a VPN or a phone on mobile data to simulate a visitor from another country, always in a logged-out/incognito window. See Currency localisation for exactly how detection works.

The dashboard shows no activity

An empty analytics panel on a fresh install is completely normal. GeoSync Pro only counts guest, public-IP visits while the feature is enabled — and it never backfills past traffic.

• Your own admin sessions and any private/localhost IPs are never counted.
• Test in an incognito window from a public IP to generate a real, countable visit.
• If you updated by replacing files without reactivating, the analytics table may not exist yet. Deactivate and reactivate the module once (under Setup → Addon Modules) so it's recreated — your configuration is preserved.

See Analytics for what each figure means, including the localisation rate (the share of guests served a non-default currency).

The currency switcher still shows

Hide Currency Switcher (on the Currency tab) hides the currency dropdown and the registration-page currency field for guests — but only on the built-in WHMCS templates Six, Twenty-One and Nexus.

If you use a third-party theme or order form (for example Lagom), you may also need to disable the switcher in that theme's own settings. GeoSync Pro warns you on-screen when your active template or order form is a non-default one.

WARNING

GeoSync Pro can't reach into a third-party theme's markup. Turn its switcher off there too, then re-check in an incognito window.

File-integrity warnings

GeoSync Pro verifies its own files with HMAC-SHA256 checksums so tampering — to files or the database — is detectable. If the Sync Status panel flags a mismatch, it's usually harmless drift from an interrupted upload or a file replaced during an update.

• Open Addons → GeoSync Pro → Settings → Sync Status to see the verification status and history.
• Auto-Sync re-deploys and repairs the affected files automatically on the next admin page load, so most mismatches resolve themselves at the next sync. You can also trigger a manual Sync; on success you'll see "Sync completed successfully."

More detail: Sync Status.

Updates won't apply

If Check for Updates or Update Now don't behave:

• The directory must be writable. Updates back up files first, then apply — the module needs write access to its own folder and enough disk space.
• Your license must be active for updates to run.
• Read the on-screen message. If you see a published but its download is not yet available message, the release was announced but its installer isn't live yet — try again shortly. A Failed to download update… message points to blocked outbound HTTPS or an unauthorised build, and Backup verification failed… means the update stopped before changing anything, so check writability and free disk.

Every one of these strings, with what to do next, is in the Error reference.

"Update Now" is disabled

Two reasons this happens:

• You have a Lifetime license and Support & Updates has ended. Your installed version keeps working forever, but new versions require an active Support & Updates plan. Renew it and Update Now re-enables. (A Leased license includes updates while the subscription is active.)
• The release's installer is still publishing. A new version was announced but its download isn't live yet — Update Now stays disabled until it is.

Check your license type and Support & Updates status under Addons → GeoSync Pro → Settings → License Information. For the full picture, see Licensing and Updates & backups.

Still stuck?

Turn on Debug Mode under Addons → GeoSync Pro → Settings → General Settings to log GeoIP lookups and currency resolution to the WHMCS Activity Log, then reproduce the issue and review the log. Turn it back off when you're done.