Geolocation rules, speed and SEO
Build geolocation rules around a deliberate delivery plan. Local lookup can avoid a per-visitor API request, while public caching and search visibility need…
WPLocation documentation
From your first install
to your first country rule.
Set up Free, add Pro for WooCommerce, and check the result on your real site. Clear steps for the software available today.
Current releases: Free 1.0.0 (WordPress.org) · Pro 1.4.5
Two plugins. Two different keys.
Free works on its own without a paid WPLocation key. Keep it active when using Pro.
- MaxMind key
- In WPLocation → Settings.
Authorizes country database downloads. - WPLocation Pro key
- In the inline Your Pro license panel.
On Overview or Product rules, depending on your Free edition. Activates paid updates and support.
Find your next step
Browse the guides.
Getting Started
Installation, setup and the first successful country check.
Get a free MaxMind GeoLite2 Country database for WPLocation
Connect your own MaxMind account and download a private country database.
Install and set up WPLocation
Install Free, connect your country source and test your first audience.
Content Rules
Choose and test country audiences for WordPress content.
Choose the right country rule
Decide whether to target a page, post, category, block, shortcode, or WooCommerce product, and understand how overlapping rules combine.
Use the Country visibility block
Show or hide a section inside a page or post with WPLocation’s server-rendered Gutenberg block.
Manage WordPress categories by country
Set country audiences for WordPress post categories in WPLocation Free. Select countries, save the rule and check allowed and denied results.
Manage WordPress pages by country
Show or hide a WordPress page by country with WPLocation Free. Follow the current editor steps, saved-rule tests and cache checks.
Manage individual posts by country
Apply a country audience to one WordPress post in WPLocation Free. Check category overlap, saved results and the public visitor experience.
What visitors see when content is restricted
Understand blocked pages, unknown locations, and the current message settings.
WPLocation shortcodes
Use WPLocation Free shortcodes to show country-specific content or display the detected country. Includes attributes, examples and cache guidance.
Data & Accuracy
Local country databases, IP detection and data freshness.
How country detection works and where it can be wrong
Learn how local IP lookup, proxies, mobile networks and unknown addresses affect a rule.
Keep the country database current
Maintain a licensed private GeoLite2 Country file, understand opt-in updates, and recover from a failed update.
Troubleshooting
Cache safety, diagnostics and practical fixes.
Page cache and CDN safety
Prevent a shared cache from showing one visitor another country’s version of a page.
Test and troubleshoot country detection
Use Diagnostics and a simple test matrix to isolate source, rule, and cache problems.
Pro features
Licensed Pro setup, country-aware commerce, redirects, forms and analytics.
Pro Installation and Licensing
Add Pro, activate your purchase key, manage renewals and prepare legacy upgrades.
Set up Forms & Campaigns
Choose an existing Formidable form or native offer by visitor country in WPLocation Pro.
Set up Geo Analytics
Enable opt-in aggregate country reports in WPLocation Pro and understand retention, exports and measurement limits.
Set up Geo Redirects
Create and test country-aware page routes included with WPLocation Pro.
Set up WooCommerce Markets
Create and test regional storefront and checkout method rules included with WPLocation Pro.
Test WooCommerce country rules end to end
Check product visibility, cart changes and checkout countries before relying on a Pro audience.
WooCommerce product and category country rules
Set product and product-category audiences in the released Pro plugin, then check catalog, cart and checkout behavior.
Separate add-ons
Install and configure separate WPLocation plugins included with eligible plans or offered free.
Set up Affiliate Link Localization
Configure approved Amazon Associates and Impact links with a direct default, country choices and cache-safe fallback.
Set up Agency Toolkit
Transfer reviewed Free and Pro country rules between WordPress sites with Agency Toolkit.
Set up CloudFront Country Source
Configure a verified origin token, CloudFront viewer headers and safe cache policy.
Reference & FAQ
Quick answers and developer integration notes.
Frequently asked questions
Find answers about Free, Pro, licenses, country sources and caching.
Trusted proxy and visitor IP setup
Understand the verified client IP filter and avoid trusting a forged forwarded header.
Historical Preview
Past experiments that are not part of the current releases.
DB-IP Country Lite: availability and tradeoffs
Historical preview only. Learn why DB-IP is excluded and which country source to use in the current release.
No matching guides. Try a shorter search or select All guides.
Still need a hand?
Tell us the versions, rule type and expected result. Keep license keys and download links private.
Contact support →Compare Free and Pro