> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-engage/17.latest/marketers-and-editors/analytics/location.md).

# Location

Learn about what localization data is tracked and how you can view it.

{% hint style="info" %}
Locations are not visible out of the box. You need to add a location provider which can be set up by a development team.
{% endhint %}

The localization information is displayed under the **Locations** tab in the **Analytics** section of Umbraco Engage:

![Location tab, located under the Analytics section](https://1498851568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeiQnEGdbGIoA0IQ3nJUK%2Fuploads%2Fgit-blob-3bed2fc63e3b6b60b96a777822b0b6e70612df5f%2FLocations-tab-v16.png?alt=media)

The graph contains all sessions started within the given time, similar to the "**Visitors**" tab. This information is not location-bound and the graph is always displayed, even if no localization information is available.

Underneath the graph, is the table containing session and pageview information based on country.

If the pageviews contain location information, the table with countries is displayed:

![Location table with data](https://1498851568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeiQnEGdbGIoA0IQ3nJUK%2Fuploads%2Fgit-blob-7656e8af4e6a9f1b97474fa85ba4c666eaf104d9%2FLocations-Analytics-v16.png?alt=media)

There might be cases where you see a message saying that no data is available or that all locations are `<unknown>`. This will occur when the [LocationExtractor](/umbraco-engage/17.latest/developers/analytics/extending-analytics/getting-the-correct-ip-address.md) service is not implemented, or if the pageviews for the given date range do not contain location information. Please consult the technical team to implement the location extractor.

From the country, you can drill down to a city. This will filter the displayed data to display session and pageview information for the selected country. Even though Umbraco Engage does support the storage for county and province, currently the UI only supports displaying data by country and city.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.umbraco.com/umbraco-engage/17.latest/marketers-and-editors/analytics/location.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.