Cloudflare Docs
Edit this page on GitHub
Set theme to dark (⇧+D)

IP geolocation

IP geolocation adds the CF-IPCountry header to all requests to your origin server.

Cloudflare automatically updates its IP geolocation database using Maxmind source data, typically twice a week.

​​ Availability




​​ Add IP geolocation information

The recommended procedure to enable IP geolocation information is to enable the Add visitor location headers Managed Transform. This Managed Transform adds HTTP request headers with location information for the visitor’s IP address, such as city, country, continent, longitude, and latitude.

If you only want the request header for the visitor’s country, you can enable IP Geolocation.

To enable IP Geolocation in the dashboard:

  1. Log in to your Cloudflare account and go to a specific domain.
  2. Go to Network.
  3. For IP Geolocation, switch the toggle to On.
To enable IP Geolocation with the API, send a PATCH request with the value parameter set to "on".

​​ Report an incorrect IP location

If you find an incorrect IP location, report to [email protected].