Now available

WPLocation Free is on WordPress.org

View the plugin ↗

WPLocation

Country-aware content for WordPress

  • Features
  • Demo
  • Add-ons
  • Pricing
  • Blog
  • Account
  • Get Pro
← All documentation/Install and set up WPLocation
Free

Install and set up WPLocation

For the current releases: Free 1.1.14 (WordPress.org) and Pro 1.4.5.

On this page
  1. Start on WordPress.org.
  2. Before you start
  3. Install and activate Free
  4. Configure country detection
  5. Create and test a first rule
  6. Check caching and unknown locations
  7. Keep Free current
  8. Add Pro when your store needs it
  9. Upgrade Free safely
  10. Search visibility, sitemaps and caching
Free setupPro & licensingMy account & downloadsFree on WordPress.org ↗

Install WPLocation Free from WordPress.org, configure a current country database and test your first geolocation rule. Pro and add-ons extend this one Free foundation.

Upgrading the original standalone 1.0.0? Prepare your current private database with the legacy upgrade steps before replacing the old plugin. A normal folder replacement removes its bundled database.

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.

WPLocation Free · WordPress.org

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 Free ↗

No 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 →

Before you start

  • Free requires WordPress 6.8+ and PHP 7.4+. Pro requires PHP 8.3+.
  • Back up and test on staging, especially when replacing an older standalone build.
  • Have a current licensed GeoLite2 Country database or your own MaxMind account ready. No database is bundled.

Install and activate Free

  1. Open Plugins → Add Plugin in WordPress and search for WPLocation.
  2. Choose WPLocation – Geolocation and Country Rules by Jazib Zaman, then select Install Now → Activate.
  3. Alternatively, get the ZIP from WordPress.org and use Plugins → Add Plugin → Upload Plugin.
  4. Open WPLocation → Settings. Free needs no paid WPLocation key.

Configure country detection

Open WPLocation → Settings and choose one of these paths:

Use your MaxMind account

Select Use MaxMind, enter your account ID and MaxMind license key, then select Save account. Choose an existing writable private directory outside the public web root. Review the download consent and select Download and select MaxMind.

MaxMind setup walkthrough →

Use an existing private file

Under Local database, enter the absolute path to a current, readable GeoLite2 Country MMDB you are licensed to use, then choose Select this database. Keep it outside the web root and plugin directory.

Database maintenance guide →

Use WPLocation → Diagnostics to confirm a readable GeoLite2-Country source, review its build date and test a public IP address you are permitted to test. Resolve source errors before relying on a country rule.

Two different keys: a MaxMind key authorizes database downloads from MaxMind. A WPLocation Pro key activates paid Pro updates and support. They are not interchangeable. Local visitor lookups need no WPLocation credits.

Automatic database updates are opt in. After checking the source, enable Enable daily database update checks in Settings if wanted, then Save update settings. WP-Cron needs site traffic or a configured server cron.

Create and test a first rule

  1. Create and save a test page in WordPress.
  2. Open WPLocation → Pages, find the page and select its title.
  3. Choose Only selected countries or Everywhere except selected countries. Select at least one country and review the audience summary.
  4. Select Save visibility. Under Check the saved result, choose one allowed country and one denied country.
  5. To remove the restriction, choose Everyone and save. The current editor requires at least one country for a restricted audience; do not use a blank selection as a setup step.
Actual WPLocation Free page-audience editor using demo content for Canada and the United States.
Actual Free 1.1.0 editor with demo content. Select the image to enlarge it.

Check caching and unknown locations

Purge your page and CDN caches, then test the public URL from an allowed and denied location. Repeat the requests after the cache has been populated. A saved-rule test checks the rule; it does not prove that the public cache serves the right result.

Unknown countries are hidden by an active restriction. A blocked singular Free page or post returns your theme’s 404 response. Unrestricted content remains available. IP location is approximate and cannot secure confidential information.

Follow the cache checklist and troubleshooting steps if the public result differs.

Keep Free current

Free downloads and updates come from WordPress.org. There is one Free plugin. Pro and add-on downloads come from your WPLocation account or their documented product page. Read the changelog and back up before updating.

Add Pro when your store needs it

For WooCommerce product and product-category audiences, install Pro as a second plugin and keep Free active. Follow Pro installation and licensing. For content-only work, continue with page rules, the Country visibility block or shortcodes.

Upgrade Free safely

There is one Free plugin, installed and updated through WordPress.org. The WordPress.org plugin includes the applicable improvements from the retired website build. Keep Free active with Pro 1.4.5 or newer.

  1. Back up the database, plugins and country rules. Test the update on staging first; on multisite, prepare each site separately.
  2. Confirm your current licensed GeoLite2 Country MMDB is readable outside both the public web root and the plugin folder. If the old standalone plugin stores its only database inside the plugin folder, prepare a current private database before replacing it. WordPress removes that folder during updates; obsolete bundled data is not copied or restored.
  3. Save the private path in WPLocation → Settings when available, or have your administrator define WPLOCATION_GEOIP_DB_PATH in wp-config.php for the new release. That constant takes priority. Never put a database, credentials or private server path into a support post.
  4. Update WPLocation through Dashboard → Updates. Open WPLocation → Overview, check the source status, then run a private lookup in Diagnostics.
  5. Check an allowed country, a denied country and an unknown location. Clear your page/CDN cache and test actual delivery.

Saved rules, content and private database options are retained. Standard post and text-widget rendering translates old markup to without registering the old unprefixed tag or rewriting posts. Escaped examples stay unchanged; another plugin that owns that tag keeps ownership. Review custom fields, page builders and direct do_shortcode() integrations separately.

If the country source is missing, restricted output stays hidden. Restore or configure a current licensed private source in Settings, check Diagnostics and purge caches. Free does not bundle location data or require a paid WPLocation key.

Search visibility, sitemaps and caching

Free 1.1.11 makes WordPress core sitemap URL lists independent of the visitor requesting XML, including their pagination. Real page and REST requests still respect country rules: a whole-page rule may return a 404 to a crawler outside the audience. A sitemap entry does not guarantee indexing.

Keep essential general information public and use the visibility block or prefixed shortcode for regional sections. WPLocation does not create translations, regional URLs, hreflang tags or ranking guarantees.

Shared-cache protection remains enabled because blocks, shortcodes, secondary queries and Pro can personalize a response. A CDN or page cache may run before WordPress. Bypass personalized HTML or use a separately validated country-aware configuration; clear caches after changes and test allowed, denied and unknown locations. Do not disable protection just because the main page has no audience.

Update Free through WordPress.org, keep it active with Pro, and follow the private database precautions above. Read the release notes →

Where to next?

Choose the right country rule →Check your cache and CDN →Browse all guides →
Need help with this guide?

Contact WPLocation with your software versions and the result you expected. Keep keys and customer data private.

Free on WordPress.org ↗Release notesFree support forumPro support & report an issue

Company

  • About us
  • Contact
  • Terms & Conditions
  • Privacy Policy

Product

  • Features
  • WPLocation Pro
  • Pricing
  • Add-ons roadmap
  • Get WPLocation

Resources

  • Blog
  • Documentation
  • Installation
  • Shortcodes
  • Changelog

Account & Support

  • My Account & Licenses
  • Contact Support
  • Blocked-content behavior

Copyright © 2026. WPLocation is a project of TechAbout LLC.
Questions? [email protected]