# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.