---
title: Settings - Geolocation
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

You can access these settings in the **Settings** application under the **On-line marketing** -> **Contact management** -> **Geolocation** category.

| General                                                                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable contact geolocation by IP                                                                                                                                                                                                                                       | Indicates if the system tracks the geographic locations of contacts based on their IP addresses.<br>Only works if you add a MaxMind geolocation database to your web project (see [Using geolocation for contacts](https://docs.kentico.com/13/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-contacts/using-geolocation-for-contacts.md)). |
| Suffix for mapped data                                                                                                                                                                                                                                                 | Allows you to specify an optional suffix, which the system adds to the values of contact fields obtained using geolocation. The suffix is only added to text-based fields.                                                                                                                                                                                                                      |
| Geolocation data to contact fields mapping                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                 |
| This section allows you to configure the mapping of the geolocation data to the fields of Xperience contacts. Use the drop-down lists to select the target fields into which the system maps the information. Mind the type restrictions when assigning target fields. |                                                                                                                                                                                                                                                                                                                                                                                                 |
| Country                                                                                                                                                                                                                                                                | Accepts integer-based and text-based fields.<br>When mapping to integer fields, the _Country ID_ value is used<br>Text-based fields use the _Country display name_ value                                                                                                                                                                                                                        |
| State                                                                                                                                                                                                                                                                  | Accepts integer-based and text-based fields.<br>When mapping to integer fields, the _State ID_ value is used<br>Text-based fields use the _State display name_ value                                                                                                                                                                                                                            |
| City                                                                                                                                                                                                                                                                   | Accepts text-based fields.                                                                                                                                                                                                                                                                                                                                                                      |
| Postal code                                                                                                                                                                                                                                                            | Accepts integer-based and text-based fields.                                                                                                                                                                                                                                                                                                                                                    |
| Metro code                                                                                                                                                                                                                                                             | Accepts integer-based and text-based fields.                                                                                                                                                                                                                                                                                                                                                    |
| Latitude                                                                                                                                                                                                                                                               | Accepts floating-point number and text‑based fields.                                                                                                                                                                                                                                                                                                                                            |
| Longitude                                                                                                                                                                                                                                                              | Accepts floating-point number and text‑based fields.                                                                                                                                                                                                                                                                                                                                            |
| Organization/ASN (GeoLite2 ASN required)                                                                                                                                                                                                                               | Accepts text-based fields.<br>Note: Organization data is only available if you add the [GeoLite2 ASN](https://dev.maxmind.com/geoip/geoip2/geolite2/) database to your project.                                                                                                                                                                                                                 |

> **Info:** By default, Xperience contacts do not have fields for storing the **Metro code**, **Latitude** and **Longitude** geolocation data. To learn how to create custom fields for holding the data, see [Adding custom fields to contacts](https://docs.kentico.com/13/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-contacts/adding-custom-fields-to-contacts.md).