WPLocation Free · on WordPress.org
Free WordPress geolocation.
Clear country rules.
Choose the countries that can see posts, pages, categories and content sections. Install the one WPLocation Free plugin from WordPress.org, then add Pro when you need more.
Free downloads and updates come from WordPress.org. No paid WPLocation license is required.

Clear audiences.
Choose who sees your content by country. Add Pro for product availability, regional pages and more workflows.
Explore the rules →Local country lookup.
Local MMDB lookups avoid a visitor-by-visitor API call. Test your page cache and CDN so performance never changes the audience result.
Plan cache delivery →Deliberate crawl access.
Use discoverable regional URLs and a visitor choice for SEO landing pages. Country visibility rules alone do not create hreflang or guarantee rankings.
Read the SEO guide →Useful from the first rule
Choose an audience. Check the result.
Content audiences
Include or exclude selected countries for posts, pages and post categories. Applicable post and category rules work together.
Content sections
Use the Country visibility block or wplocation_target shortcode. Show the detected country with wplocation_country.
Diagnostics
Check the country source and a saved rule, then test allowed, denied and unknown results on the real site.
One Free plugin
Start on WordPress.org.
Install WPLocation Free from your WordPress dashboard. Free downloads and updates come from WordPress.org; Pro and add-ons come from WPLocation.
Your geolocation-rule foundation.
Set post, page and category audiences, use the Country visibility block and shortcodes, and check the private country source in Diagnostics.
Install WPLocation FreeNo paid WPLocation license. Published Free requires WordPress 6.8+ and PHP 7.4+. Pro requires PHP 8.3+ and stays installed alongside Free.
Local lookups require a current licensed GeoLite2 Country database. Setup and legacy upgrade guide →
Setup requirements
A current source. A deliberate rule.
Free requires WordPress 6.8+ and PHP 7.4+. Supply a current licensed GeoLite2 Country MMDB outside the public web root, or explicitly download one with your own MaxMind account. No country database is bundled.
Local lookups keep visitor IPs on your server. Optional database downloads contact MaxMind and its file provider; automatic update checks are opt in.
Existing installations
Upgrading an older standalone build?
Back up first. Older builds stored a database inside the plugin folder and used a legacy shortcode. Follow the preparation guide before replacing them. Applicable improvements from the retired website build ship in the Free plugin on WordPress.org. There is one Free plugin.
Start with a clear country rule.
Get Free from WordPress.org. Pro and specialist add-ons are available from WPLocation.
New in Free 1.1.11
Consistent sitemaps. Faster country rules.
Published URL lists stay consistent across visitor countries, and bulk rule lookups avoid a query for every saved page audience. The editor explains SEO and cache effects. Existing rules and private source settings are retained.
Put a country rule to work
Show WordPress content by country.
Start with a small content change you can preview and test.
Regional announcements
Show a country-specific notice inside a WordPress page with the Country visibility block. Keep the main page useful to everyone.
Country-specific content
Include or exclude selected countries for posts, pages or categories. Whole-page restrictions can return a 404 to visitors and crawlers outside the audience.
Targeted content sections
Use the prefixed shortcode to show a selected message or section by country. Local lookup uses your own current licensed country database.
Before you install
Free geolocation plugin questions.
What does the Free WordPress geolocation plugin include?
Country audiences for posts, pages and categories, the Country visibility block, prefixed shortcodes, Diagnostics and a private activity log. Install and update the single Free plugin through WordPress.org.
Does Free require a WPLocation license or a geolocation API subscription?
No paid WPLocation key or per-visitor lookup subscription is required. Local detection needs a current licensed GeoLite2 Country database. You can supply a private file or download one with your own MaxMind account and license key; automatic database updates are opt in.
Can I show different sections on the same page?
Yes. Use the visibility block or [wplocation_target] shortcode for country-specific sections. Restricted sections stay hidden when the country is unknown, so keep important general information outside them.
Does geotargeting automatically improve SEO?
No. Country visibility does not create regional URLs, translations or hreflang annotations, and it does not guarantee rankings. A country rule can also hide content from a crawler in that country. Use discoverable regional URLs where needed and follow the geolocation and SEO guide.
Will it work with a page cache or CDN?
Free requests uncached frontend HTML to prevent country content from being shared incorrectly. A cache that answers before WordPress can still bypass these rules. Check the cache and CDN test matrix on your actual site.
Is this a firewall or a way to secure confidential content?
No. IP geolocation is approximate. Use proper authentication and access controls for private material; country visibility is for personalization.
