Documentation
GeoBlock Pro
Settings
Advanced Options

Advanced Options

Go to WooCommerce → GeoBlock → Advanced.

OptionDefaultDescription
Force GeolocationOffAlways use IP detection, ignoring logged-in customers' saved addresses
Analytics LoggingOffRecord restriction events for the Analytics tab
Debug ModeOffShow a detection toolbar at the bottom of every frontend page to shop managers and administrators

Force Geolocation

StateBehaviour
Off (default)Logged-in customers are identified by their saved shipping address first, then billing address, then IP
OnIP-based detection is always used, even for logged-in customers with saved addresses

When to use: Enable if your customers' shipping addresses may not reflect their physical location - for example, if they use freight forwarders, P.O. boxes, or re-shipping services.

⚠️

Enabling Force Geolocation means a customer in Germany who ships to a US address will be detected as Germany. Disable it if your rules should follow the shipping destination rather than physical presence.


Analytics Logging

When enabled, GeoBlock Pro records each restriction event (country, rule, product and payment method) in the {prefix}geoblock_analytics table so it can be reported on the Analytics tab. It is off by default - no data is collected until you turn it on.


Debug Mode

When enabled, a debug toolbar appears at the bottom of every frontend page. It is visible only to shop managers and administrators - regular visitors never see it.

The toolbar displays:

FieldDescription
CountryFlag emoji, country name, and 2-letter ISO code
IPThe visitor's detected public IP address
SourceHow the country was determined (see Geolocation)
WC GeoWhether WooCommerce geolocation is enabled in store settings
Force GeoShown when Force Geolocation is active

Rule Testing

The Rule Testing panel lets you check your rules without a VPN and without affecting live customers.

TestWhat it does
One-Click Quick TestClick Run Quick Test to check a few random products and payment methods against your detected country
Test a ProductChoose a product and a country, then click Test Product to see whether the product is restricted and which rule applies
Test CheckoutChoose a payment method and a billing or shipping country to see whether a payment rule would hide that method
💡

Rule Testing only reads your rules - it doesn't change anything and isn't recorded in analytics.