---
url: /geosync-pro-whmcs/troubleshooting.md
description: >-
  Fix the most common GeoSync Pro issues — addon access, currency not switching,
  an empty dashboard, a stubborn currency switcher, file-integrity warnings and
  update problems.
---

# 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](/geosync-pro-whmcs/features/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](/geosync-pro-whmcs/features/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](/geosync-pro-whmcs/features/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](/geosync-pro-whmcs/errors).

## "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](/geosync-pro-whmcs/licensing) and [Updates & backups](/geosync-pro-whmcs/updating).

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