Advanced Options
Navigate to WooCommerce → GeoBlock → Advanced to configure the advanced options.
Options
| Option | Default | Description |
|---|---|---|
| Force Geolocation | No | Re-detects country on every page load, ignoring session cache. Useful for VPN-heavy audiences; adds latency. |
| Catalog Purchasable | No | When Block Purchase mode is active, controls whether hidden products are still purchasable via direct URL. |
| Debug Mode | No | Shows a debug toolbar at the bottom of every page listing detected country, detection method, and matched rule. Visible to admins only. |
Force Geolocation
By default, GeoBlock caches the detected country in a session transient to avoid repeated MaxMind database lookups. Enabling Force Geolocation bypasses this cache and re-detects the country on every page load.
Enable this if:
- Your store serves a high proportion of VPN users who change locations between sessions.
- You are testing restrictions and want the detection to refresh without clearing session data.
Force Geolocation adds a small amount of latency on each page load due to the MaxMind lookup. Leave it disabled unless needed.
Debug Mode
When enabled, a debug toolbar appears at the bottom of every page for logged-in administrators. It displays:
- Detected country code
- Detection method used (IP, session, billing address, etc.)
- Matched rule (type and ID) for the current product
- Current visitor IP address
Debug Mode is visible to administrators only and does not affect the experience for regular visitors.