Troubleshooting

Find your symptom and work the steps in order. Most issues come down to a setting, a missing currency, admin access, or testing from the wrong browser window.

The addon page is blank, shows only the license field, or "Access Denied"

• Grant admin permissions: GeoSync Pro requires Full Administrator role access. Assign access under Configuration → System Settings → Administrator Roles to resolve Access Denied errors.
• Activate license: First-time access displays only the License Information tab. Enter a valid key in Addons → GeoSync Pro → Settings → License Information to unlock remaining tabs.

Currency isn't switching

Run through this list in order:

1. Enable the feature. Addons → GeoSync Pro → Currency → confirm Enable Currency Localisation is on.
2. Check your license. Localisation only runs with an active license — Addons → GeoSync Pro → Settings → License Information. A lapsed license pauses the feature.
3. Check the mapping. In Country-to-Currency Mappings, ensure a row exists for the visitor's ISO 3166-1 alpha-2 code (e.g. IN, GB, JP), or that an EU rule covers them.
4. Check the currency exists. The mapped currency must be present and active under Setup → Payments → Currencies, or GeoSync Pro falls back to your Default Currency.
5. Test correctly: Localisation applies only to guests on public IPs. Logged-in users retain profile currencies, and private/localhost IPs (127.0.0.1, 192.168.x.x) cannot be geolocated. Test using a logged-out or incognito window on a public connection.

TIP

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

The dashboard shows no activity

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

• Excluded traffic: Admin sessions and private/localhost IP visits are never tracked.
• Verification test: Visit the client area from an incognito window on a public IP.
• Manual updates: If files were replaced manually without reactivating, deactivate and reactivate under Setup → Addon Modules to regenerate analytics tables.

See Analytics for what each figure means.

The currency switcher still shows

Hide Currency Switcher (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.

Third-party themes or order forms (such as Lagom) require disabling switchers in theme settings. GeoSync Pro displays an on-screen notice when a non-default template is detected.

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. A flagged mismatch is usually harmless drift from an interrupted upload or a file replaced during an update.

1. Addons → GeoSync Pro → Settings → Sync Status — review the verification status and history.
2. Auto-Sync re-deploys and repairs affected files automatically on the next admin page load, so most mismatches self-resolve.
3. Trigger a manual Sync if needed; on success you'll see "Sync completed successfully."

More detail: File integrity.

Updates won't apply

Settings → Update Status → Check for Updates → Update Now. If it won't behave:

• Directory permissions: Ensure write permissions on the module folder and sufficient disk space for pre-update backups.
• License status: Verify that your license is active.
• Review error notices:
  • Download not yet available: Release is announced but installer package is still syncing; retry shortly.
  • Failed to download update: Server cannot establish outbound HTTPS connections or build is unauthorized.
  • Backup verification failed: Update halted safely before applying changes; verify disk space and write permissions.

Every string, with what to do next, is in the Error reference.

"Update Now" is disabled

Two reasons:

• Expired Support & Updates (Lifetime): Perpetual licenses require an active Support & Updates plan to install newer versions. Existing installs continue functioning indefinitely.
• Installer publishing: Release is registered but the download package is still processing; Update Now enables once live.

Check your license type and Support & Updates status under Addons → GeoSync Pro → Settings → License Information. 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 done.