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