Documentation
GeoBlock Pro
Troubleshooting

Troubleshooting

Product Not Hiding for Restricted Country

Check Debug Mode

Enable Debug Mode (WooCommerce → GeoBlock → Advanced) and confirm the detected country is correct.

Verify rule configuration

Check that the bulk rule or product rule is saved and the correct country is selected.

Confirm MaxMind database

Verify that WooCommerce MaxMind GeoLite2 is configured and the database file exists.

Clear cache

If using a caching plugin other than WP Rocket or SiteGround Optimizer, clear the cache and test from a private browsing window.


Variation Rule Not Firing

Check the variation rule

Confirm the rule is saved on the correct variation (not the parent product).

Select a specific variation

Test with a specific variation selected - variation rules only apply when a variation is chosen.

Check for JavaScript errors

Open browser console for JavaScript errors that might prevent the variation selection from registering.


Bulk Rule Appears to Not Apply

Confirm product membership

Confirm the product belongs to the category/tag/attribute you targeted.

Check rule priority

Check whether a higher-priority per-product rule is overriding the bulk rule.

Save changes

Refresh the bulk rules list - unsaved changes are discarded on page navigation.


Analytics Shows No Events

Check analytics setting

Confirm analytics_enabled is set to yes in GeoBlock settings.

Verify the database table

Confirm the {prefix}geoblock_analytics table exists using a database tool (phpMyAdmin, TablePlus).

Test restrictions

Check that restrictions are actually triggering - test with Debug Mode and a VPN.


License Shows "Invalid" After Activation

Check the key

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

Verify site URL

Confirm your site's URL matches the license registration in your WindCodex account.

Check outgoing HTTP

Ensure outgoing HTTP requests from your server are not blocked by a firewall (wp_remote_post to windcodex.com must succeed).