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.

​​ 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, use the Maxmind tool to make sure that Maxmind shows the correct Country Code. If the data is incorrect: