IP address and location properties

This article helps you:

Understand Amplitude defines and uses location properties to enhance your analyses
Understand how Amplitude tracks location properties when IP addresses are blocked or filtered out

Data that highlights user location properties, such as a user's city and country, are crucial for generating insights related to the geographical distribution of your users. They can show you how user preferences and behaviors differ from region to region, and help you better optimize your product.

How Amplitude tracks location properties

Amplitude uses the MaxMind database to look up location information from the user's IP address. Even though MaxMind data is generally highly reliable, the accuracy and availability of city and region information can vary by country.

By default, Amplitude uses the GeoIP to gather location property values based on location_lat and location_long. You may explicitly define how Amplitude tracks a user's location properties server-side. Amplitude's HTTP API allows you to send your own [Amplitude] City, [Amplitude] DMA, [Amplitude] Region, and [Amplitude] Country values with your events.

Note

If you choose to send these values, Amplitude doesn't modify them to reflect GeoIP. Always update all four fields together, as setting any one of the fields resets the others.

How Amplitude determines location properties when IP address is blocked or filtered out

Even if you have chosen to block or filter IP addresses in your data ingestion, Amplitude uses the IP address to find location properties. The following steps outline how this works in the backend:

An event is uploaded with an IP address.
Amplitude uses the IP address to find the location data, and adds all the relevant fields to the event.
The system looks at the tracking options and filters for the project, excluding blocked or filtered fields as applicable.
When you look at this specific event in Amplitude, it doesn't have an associated IP address. However, it has related location properties, such as city and country.

If you are using an SDK and want Amplitude to drop IP addresses, configure the options within the SDK. If you want to remove IP addresses on events moving forward, file a Service Task request on the Support form.