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/Pro Installation and Licensing
Pro

Pro Installation and Licensing

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

On this page
  1. New installation
  2. Activate and manage your license
  3. Understand plans, renewals and expiry
  4. Create and test a product audience
  5. After checkout
  6. Upgrading the original Free 1.0.0
  7. Privacy and dependencies
  8. Geo Redirects in Pro 1.1.0
  9. WooCommerce Markets in Pro 1.2.0
  10. Forms & Campaigns in Pro 1.3.0
  11. Geo Analytics in Pro 1.4.5
  12. Agency Toolkit 1.0.1
  13. Free dashboard
Free setupPro & licensingMy account & downloadsFree on WordPress.org ↗

Install Free first, configure its country source, then add Pro and activate your purchase key. Keep both plugins active: Free supplies country detection; Pro adds WooCommerce product controls.

One Free foundation: install WPLocation Free from WordPress.org, then install Pro from your WPLocation account. Keep both active. Pro 1.4.5 has been tested with Free 1.1.11 and requires PHP 8.3+.

The older standalone 1.0.0 build needs the migration below before replacement. The current Free plugin is distributed and updated through WordPress.org.

New installation

  1. Check the environment. Back up and test on staging. Use WordPress 6.8+, PHP 8.3+ and WooCommerce for product targeting. Initial testing covers single-site WordPress 6.8.3 and 7.1.3, WooCommerce 11.2.1 and PHP 8.3. Broader multisite and custom checkout compatibility need separate testing.
  2. Install Free. Download WPLocation Free, upload it under Plugins → Add Plugin → Upload Plugin, then activate it. Follow the full Free setup guide.
  3. Configure the source. In WPLocation → Settings, select a current licensed GeoLite2 Country MMDB outside the public web root, or explicitly download one with your own MaxMind account. Check Diagnostics. Automatic data updates remain off until you opt in.
  4. Install Pro separately. After purchase, download the Pro ZIP from My Account → Downloads or your receipt. Upload and activate it while Free remains active. Activate WooCommerce if it is not already running.
  5. Activate the Pro license. Follow the license steps below, then create and test your first product audience.

Activate and manage your license

  1. Find your WPLocation Pro purchase key in My Account → License keys or the purchase receipt.
  2. In WordPress, open WPLocation → Overview and find the inline Your Pro license panel. With WPLocation Free 1.0.0 or older pre-directory Free builds, use the inline panel under WPLocation → Product rules. Later compatible Free builds show it on Overview.
  3. Enter the Pro key and choose Activate license. Check the returned license status. This is the WPLocation purchase key, not your MaxMind database-download key.
  4. If activation fails, check the key, its covered-site allowance and your server’s HTTPS connection to wplocation.com. Review the exact message before retrying; contact support if it persists.

Product and product-category audiences are under WPLocation → Product rules. The license panel is inline on Overview or Product rules as described above. Restore WPLocation Free from WordPress.org before testing Pro rules.

Moving a site? Deactivate the license for the old site or manage its activated sites in your account before activating it at the new URL. Check the allowance for your plan; do not assume staging sites are exempt.

Understand plans, renewals and expiry

Pro and Agency use the same Pro plugin. Current Pro plans cover one site; Agency covers five. Monthly and yearly subscriptions renew at the chosen interval until cancelled. Both lifetime options are one-time software licenses for their stated site limits. See current prices and plan terms.

Manage future renewals in My Account → Subscriptions. Cancelling a subscription keeps the current paid license term. After expiry, installed rules continue working, but updates and support require an active entitlement. A temporary licensing-service outage does not switch off installed targeting rules.

Both lifetime plans cover current and future WPLocation add-on software for their covered sites when released. Roadmap add-ons are not available today. Managed lookup credits, usage-based services and third-party charges are separate.

Create and test a product audience

  1. Open WPLocation → Product rules, then choose Products or Product categories.
  2. Select Edit audience. Choose Everyone, Only selected countries, or Everywhere except selected countries. Select countries for a restricted rule and choose Save audience.
  3. Use Test a country for an allowed and denied country. Every applicable product and category/ancestor rule must allow the visitor; variations inherit the parent product.
  4. Purge caches and test the actual catalog, direct product URL, add-to-cart, existing cart and checkout. Unknown countries cannot access restricted products. Checkout also checks the applicable shipping or billing country.

Follow the product-rule guide and complete WooCommerce test checklist.

After checkout

Your receipt includes the Pro download and license key. New customers receive a separate email to set their account password. Sign in to My Account to manage your purchase.

  • Downloads: get fresh links for the files included with your purchases.
  • License keys: copy your Pro key, check its status and use Manage Sites to review activations.
  • Subscriptions: check renewal dates and the available payment or cancellation actions. Lifetime purchases have no recurring subscription.
  • Orders & receipts: open purchase details, downloads and receipts.
  • Profile: update your contact details.

If email is missing, check junk mail and confirm the checkout email address. Use the account login/password-reset flow or contact support with your order number. Keep license keys and signed download links private.

Upgrading the original Free 1.0.0

The original standalone plugin stored its database inside the plugin directory. Replacing that folder removes the file, and the original 2018 data is too old to reuse.

  1. Back up the database and plugin folder, retain a rollback copy, and test the migration on staging.
  2. Install and activate WPLocation Upgrade Assistant 1.0.0 while legacy Free is still active.
  3. Obtain a current GeoLite2 Country MMDB you are licensed to use and place it in a private directory outside the web root. In Tools → WPLocation Upgrade, select it and confirm your permission to use it. The assistant can instead copy a recent licensed bundled GeoLite2 file to a private directory; old files are rejected.
  4. Keep the assistant active while installing the current WPLocation Free from WordPress.org ZIP with WordPress’s replacement flow. It guards supported WordPress upgrades when the source is unprepared. Manual file replacement and third-party updaters can bypass that guard.
  5. Verify Diagnostics, saved content rules, shortcodes and public output. Purge caches. Once verified, deactivate the assistant; then install Pro if needed.

No unattended update is offered from the original standalone release. Multisite migration is outside the supported scope of this release.

Before moving an older standalone build to the WordPress.org plugin, convert saved [locationtarget]...[/locationtarget] content to [wplocation_target]...[/wplocation_target] on staging before replacing the old plugin. Review posts, reusable blocks, widgets and custom fields, and keep your database backup. The published Free plugin uses the prefixed shortcode. The retired website build is not a download option; its applicable improvements are included in the current Free plugin on WordPress.org. Standard post and text-widget rendering translates older shortcode markup; custom integrations still need review.

Privacy and dependencies

License activation and update checks send your key, site URL and software details to wplocation.com over verified HTTPS. Optional diagnostic tracking is off by default. Keys are stored in WordPress and can appear in backups.

Free performs local country lookups; Pro adds product/category rules without a visitor IP log. Removing or deactivating Free or Pro stops Pro enforcement, although saved rules are retained. An expired license is different from a missing plugin dependency. No hosted lookup credits are included.

Review cache behavior and country-detection limits. Geo Redirects is included in Pro 1.1.0. WooCommerce Markets, Forms & Campaigns and Geo Analytics are included in Pro 1.4.5. Agency Toolkit 1.0.1 is available as a separate download to Agency subscriptions and eligible lifetime plans. It requires Free and Pro. Groups, schedules and bulk tools remain future work. Affiliate Link Localization is a released separate Pro add-on; CloudFront Country Source is included with every paid Pro plan under the parent license when its compatible paid package is released. Free 1.1.10 or newer provides the required hook; paid package delivery remains pending.

Geo Redirects in Pro 1.1.0

Geo Redirects is included in the Pro plugin; no second ZIP or license is needed. Keep Free active with a current local country database. Open WPLocation → Geo Redirects to create a published page-to-page country rule, preview it while paused, then activate it after testing your real page cache or CDN. WooCommerce purchase rules remain independent. Read the Geo Redirects guide for visitor choice, exclusions, cache behavior and troubleshooting.

WooCommerce Markets in Pro 1.2.0

WooCommerce Markets is included in Pro and needs no second ZIP or license. Keep WooCommerce and Free active. Open WPLocation → WooCommerce Markets, create a paused market, assign countries, optional shop copy and featured products, then choose allowed payment or shipping methods already configured in WooCommerce. Preview the country, activate, and test billing and shipping destinations in classic or block checkout. Markets does not change prices, currency, taxes or zones. Read the WooCommerce Markets guide.

Forms & Campaigns in Pro 1.3.0

Forms & Campaigns is included in Pro with no second ZIP or license. Open WPLocation → Forms & Campaigns, create a paused campaign with a required default, add country variants, preview the decision and activate. Place its shortcode in a page. Formidable Forms is needed to show its published forms and remains responsible for submissions; native offer cards work without it. Read the Forms & Campaigns guide.

Geo Analytics in Pro 1.4.5

Geo Analytics is included in Pro with no second ZIP or license. Collection is off by default. Open WPLocation → Geo Analytics, enable anonymous frontend request counts, choose 7, 30 or 90 days of retention and save. Review targeted content decisions, redirects and campaign displays by UTC day and country. Export aggregate CSV or delete all totals from the same screen. Cached requests can bypass WordPress; these counts are not unique visitors, conversions or revenue. Read the Geo Analytics guide.

Agency Toolkit 1.0.1

Agency Toolkit is a separate ZIP for reviewed transfer of saved Free and Pro country rules between sites. It is included with Agency monthly and yearly subscriptions and both lifetime plans for their covered sites. One-site Pro subscriptions do not include it. Read the setup guide for supported objects, review, restore and exclusions.

Free dashboard

Update Free through WordPress.org, then find the inline Your Pro license panel on WPLocation → Overview. Pro remains a separate plugin and requires PHP 8.3+. The Free upgrade guide covers private databases and older shortcode integrations.

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]