---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create a key-value pair mapping

# Create a key-value pair mapping {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Key-value pair mappings transform data in the ServiceNow platform to a value that
can be plotted on a map. Mappings are used during map source configuration when data
requires transformation. Each mapping exists in a mapping group.

## Before you begin

Role required: report_admin or admin.

## About this task

Default system key-value pairs map data to geoJSON hc-key values. All hc-key values
follow ISO 3166 standards. Default mappings exist for the most commonly used data
values. If your data uses a different value, you must create a key-value pair
mapping.

For example, the default mapping for United States of America maps key
USA to `ISO` value `us`. If your data has value of
United States instead of USA, you must make a new key-value pair to map
`United States` to ISO value `us`.

## Procedure

1. Navigate to the Locations Mappings \[sys_report_map_source_mappings\] table.
2. In the Map Source Mapping column, select the mapping group to add the mapping to.  
   Select the mapping group that corresponds to type of object that you want to create a mapping for. For example, if you are creating a mapping for field value United States, select the Country mappings group. Note that the Key and Map values in the row with the mapping aren't taken into account. Figure 1. Select map source mapping
3. Select New.
4. Fill in these fields.  
   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv__entry__2}

   | Field | Description |
   |-|-|
   | Key | The field value to transform. For example, USA. |
   | Value | The value to transform the key to. For example, us. This value is typically an ISO 3166 standard value. Each value can be used only once per map. |
   | Map | The map to associate with this mapping. If you do not fill in this field, this mapping can be used with any map. |
   [Table 1. Locations Mappings form]

   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv}
5. Select Submit to save your changes.

## What to do next

Add the mapping to a report source, so it can be used to map data from that source to
a map.
**Related concepts**   

* [Map report objects](https://servicenow-prod.fluidtopics.net/nvgfNcIFNc0kVphuRGLxxw "Map objects define the different levels that users can drill down into on a map report and the data displayed on these levels. Admins can create and manage these objects.")  
**Related tasks**   

* [Automatically generate a map source hierarchy](https://servicenow-prod.fluidtopics.net/ayM0GVQcO2gVQXBWOCCbNw "A map source hierarchy is a data source that is used to create a map report. Except for the top-level wrapper, each map source level in the hierarchy defines the data for one map drill level.")
* [Customize a map source level](https://servicenow-prod.fluidtopics.net/Q~NTYfJOw0HRcUEmVJn8Eg "A map source configures data to be displayed in a map report. Customize existing map sources according to your needs.")
* [Create a map](https://servicenow-prod.fluidtopics.net/sjcp9swq2mHSdwocXOcqbg#t_CreateAMap "Create a map that can be used in a map hierarchy.")