Troubleshooting

Geolocation Warning in Settings

Symptom: A yellow warning banner appears at the top of the GeoBlock settings page saying "WooCommerce Geolocation is not enabled."

Solution: Go to WooCommerce → Settings → General, change Default customer location to Geolocate or Geolocate (with page caching support), and save.

Products Are Not Hiding for Restricted Countries

Work through this checklist:

1. Geolocation enabled? Confirm in WooCommerce → Settings → General.
2. Correct restriction mode? In WooCommerce → GeoBlock, confirm the mode is Hide completely if you expect products to disappear from listings.
3. Rules saved on the product? Open the product and check the GeoBlock meta box. The rule summary should show the countries you've added.
4. Debug Mode shows the right country? Enable Debug Mode and visit the frontend. Confirm the displayed country matches what you expect. If a logged-in customer has a saved address in a non-restricted country, they won't be restricted unless Force Geolocation is on.
5. Caching issue? If using a caching plugin, clear all caches after making changes. For product pages specifically, ensure your caching plugin is excluding single product pages.

Restriction Message Appears Twice on the Product Page

Cause: The shortcode [geoblock_product_message] is placed in the product template at the same position that GeoBlock's automatic notice is also rendering.

Solution: Either remove the shortcode or disable the automatic notice. If you're using the shortcode for custom placement, you can unregister the automatic notice in your theme's functions.php:

remove_action( 'woocommerce_single_product_summary', array( $frontend, 'maybe_show_restriction_notice' ), 11 );

Alternatively, use only the automatic notice (no shortcode) and control its position via Message Position.

WooCommerce HPOS Compatibility Notice

GeoBlock explicitly declares compatibility with WooCommerce HPOS. If you see a compatibility warning, ensure you are running GeoBlock version 1.0.0 or later.

Plugin Was Deactivated Automatically on Activation

This happens in two scenarios:

1. WooCommerce is not installed or active. Install and activate WooCommerce, then activate GeoBlock.
2. GeoBlock Pro is active. The free and Pro versions cannot run simultaneously. Deactivate GeoBlock Pro before activating the free version (or simply keep using Pro, which includes all free features).