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 add-ons/CloudFront Country Source

Included with Pro · compatibility update in preparation

CloudFront Country Source

Use the country CloudFront already knows.

Serve WPLocation Free and Pro country rules from verified CloudFront viewer headers. No MaxMind account, WPLocation lookup credits or per-visitor API call is required for this source. Your own CloudFront distribution is required.

Check compatibility status →Read setup guide ↗
Illustration of a visitor request passing through CloudFront to WPLocation country rules, with a private origin token and local database fallback.

CloudFront → verified source → Free and Pro rules

Compatibility update in preparation

CloudFront Country Source will be included with every paid Pro plan, including Agency and lifetime, under your Pro license and site limit. No second license key is needed. Pro 1.4.5 uses the same country through Free. Free 1.1.10 or newer provides the required source hook. The licensed CloudFront 1.0.2 package is prepared and remains pending delivery; keep older CloudFront builds disabled until the compatible paid package is available. The add-on is disabled until an administrator configures a private origin token, both viewer headers and a safe cache policy.

How it works

Three checks before a country decision.

A browser-supplied country header alone is never enough. The source only trusts a request that passes the configured origin token and viewer-address checks.

01 / TRUST

Verified origin token

CloudFront supplies a custom origin header. WPLocation stores only its SHA-256 hash and checks the token on each request.

02 / VIEWER

Real viewer address

The forwarded CloudFront viewer address prevents local fallback from using a CloudFront edge IP. A missing address closes the source to unknown.

03 / COUNTRY

Validated country code

Only a known two-letter country code enters the shared Free and Pro rule engine. If absent, an optional local MMDB can use the verified viewer address.

04 / CONTROL

Clear admin status

Generate and rotate the token, explicitly enable the source and check the current request from WPLocation → CloudFront Source.

Cache-aware setup

Configure CloudFront before enabling.

Forward CloudFront-Viewer-Country and CloudFront-Viewer-Address to WordPress, and set the custom origin token. Keep personalized HTML uncached or include country in the CloudFront cache key. Account and checkout pages should never be publicly cached.

A CDN hit can bypass WordPress entirely, so verify the real distribution with at least two countries and the direct origin. The isolated release tests did not include a customer AWS distribution.

Follow the setup and cache test →

What you need

  • A compatible forthcoming Free update on WordPress.org
  • Your own CloudFront distribution in front of WordPress
  • Access to edit its custom origin headers and origin request/cache policies
  • Pro 1.4.5+ active alongside Free and this add-on

This is a WPLocation integration for Amazon CloudFront, not an AWS partnership.

Common questions

Know the boundaries.

Does it need MaxMind or paid WPLocation credits?

No, not when CloudFront provides the verified country. A local licensed MMDB is optional fallback. Your AWS distribution and transfer charges are separate.

Can I use it without CloudFront?

No. Do not enable this source for a direct-origin site. Free can continue using a locally licensed GeoLite2 Country database.

Does a verified country make content private?

No. IP location is approximate, and a CDN can serve cached content before WordPress runs. Use authentication and access controls for confidential information.

How are downloads and licensing handled?

The add-on will be delivered through your WPLocation account under the parent Pro license. Every Pro, Agency and lifetime plan includes it for its covered sites when the compatible release becomes available. No separate CloudFront license key or purchase is required. AWS infrastructure charges are separate.

Ready to connect your distribution?

Start with the verified source.

Get Pro for your current workflows. CloudFront Country Source 1.0.2 will appear in your licensed account when its paid package is released; then follow the source and cache setup guide before enabling it.

Check compatibility status →Read the guide
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]