--- url: /geosync-pro-whmcs/troubleshooting.md description: >- Fix the most common GeoSync Pro issues — currency not switching, an empty dashboard, a stubborn currency switcher, file-integrity warnings and update problems. --- # 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](/geosync-pro-whmcs/features/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](/geosync-pro-whmcs/features/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](/geosync-pro-whmcs/features/file-integrity). ## 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](/geosync-pro-whmcs/errors). ## "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](/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 you're done.