> For the complete documentation index, see [llms.txt](https://docs.adnuntius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adnuntius.com/adnuntius-data/user-interface-guide/fields/mappings.md).

# Mappings

Consider this example: One publishing website writes about football, and also asks registering users for their gender. Another publishing website that cooperates with the first one through a network also collects this information, but they call it “soccer” and “sex” instead of "football" and "gender". In order to store all information with a unified structure and language, you need to transform “soccer” to “football” and “sex” to “gender”.

This can be done with mapping. To add a mapping, go to <https://admin.adnuntius.com/mappings> and click “Add Mapping” in the upper right corner.

You can map [user profile data](https://github.com/Adnuntius/documentation/blob/master/adnuntius-data/user-interface-guide/fields/broken-reference/README.md) and [pageview data](/adnuntius-data/api-documentation/javascript/page-views.md) (which are split into categories and keywords). In the example below you will see how user profile data “gender” has been given the alias “sex” so that different parties can send different denominations, while all information will still be stored in a unified structure. If gender is sent you can also transform each value so that for example the values M and F are translated to Male and Female respectively.

![Example mapping.](/files/-MQEbnq7F0q8ywU9ZlNg)

To translate pageview keywords and categories, simply add the value as the data is sent with, in the example above “soccer”, and then define how you want to actually store the data. In the example above a publisher can send the keyword soccer, but it will be stored as the keyword “football”.

{% hint style="info" %}
Example: if you want to collect the gender (one of the [field values](/adnuntius-data/user-interface-guide/fields/fields.md) you can choose) of your users, but that you need to send the value "sex" instead of "gender". You can then map sex to gender, so that you can keep sending "sex".
{% endhint %}

{% hint style="info" %}
Example: if you’re sending both values “males” and “m” then you can transform “male” to “m” so that all variations are normalized to the same value in Adnuntius Data.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.adnuntius.com/adnuntius-data/user-interface-guide/fields/mappings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.