Documentation
GeoBlock Pro
Troubleshooting

Troubleshooting

Product Not Restricted for a Country

Test the rule

Go to WooCommerce → GeoBlock → Advanced → Rule Testing, choose the product and country under Test a Product, and click Test Product. This shows whether the rules restrict it, independent of your own location.

Check the detected country

Enable Debug Mode (same tab) and visit the product. Confirm the country in the toolbar is the one you expect. Logged-in customers are matched by their saved address unless Force Geolocation is on.

Confirm WooCommerce geolocation

Make sure Default customer location is set to Geolocate under WooCommerce → Settings → General. Without it, guests fall back to the store base country.

Clear caches

If you use a caching plugin other than WP Rocket or SiteGround Speed Optimizer, exclude product pages from the cache and clear it.


Variation Rule Not Firing

Check where the rule is saved

Variation rules are set in each variation's GeoBlock Variation Restriction section in the Variations tab - not in the product's main GeoBlock meta box.

Check the country list

A variation rule only applies when it has at least one country. An empty list means the variation follows the product and bulk rules.

Test by adding to cart

Variation rules are enforced when the variation is purchased or added to the cart.


Bulk Rule Appears Not to Apply

Confirm product membership

Check that the product is in the selected category (or a child category), has the selected tag, or has the selected attribute term.

Check the rule has countries

Rules without countries aren't saved.

Check for a variation rule

A variation with its own rule ignores bulk rules.

⚠️

Reset to Defaults resets the settings only. Bulk rules, payment rules and per-product rules are kept.


Payment Method Not Hidden

Check the method is selected

Open the rule and make sure the gateway is selected. The list shows every installed gateway by name.

Check the address

The rule uses the billing or shipping country entered at checkout (per Restrict by). Change the address at checkout and let the order review refresh.

Test it

Use Test Checkout under Advanced → Rule Testing.


Analytics Shows No Events

Turn on Analytics Logging

Analytics is off by default. Enable Analytics Logging under WooCommerce → GeoBlock → Advanced.

Trigger a restriction

Only real restriction events are recorded - Rule Testing isn't. Visit a restricted product from a restricted country (for example with a VPN).

Verify the database table

Confirm the {prefix}geoblock_analytics table exists. Deactivating and reactivating GeoBlock Pro recreates it if it's missing.


License Won't Activate

Check the key

Double-check the key for extra spaces or line breaks.

Check your site limit

Your license covers a set number of sites. Deactivate it on a site you no longer use, or upgrade your license.

Check outgoing requests

Make sure your server can reach https://windcodex.com - a firewall blocking outgoing requests prevents activation.