---
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 map

# Create a map {#ariaid-title1}

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

Create a map that can be used in a map hierarchy.{#t_CreateAMap__ph_dsp_xf1_1z}

## Before you begin

Role required: report_admin or admin.

## Procedure

1. Navigate to AllReportsAdministrationMaps, and click New.
2. Fill in the following fields as appropriate.  
   {#t_CreateAMap__table_fpx_yxx_bv__entry__2}{#t_CreateAMap__ph_hc2_dzn_1z}

   | Field | Description |
   |-|-|
   | Key | Specify a unique key that links this map to other maps. For default maps, the key is the hc-key value. The key must be included in the geoJSON of the parent map. |
   | Name | Enter a name for the map. |
   | Level | Specify the level for this map in the map hierarchy. |
   | JSON definition | Define the geoJSON for the map. You can [download predefined maps from Highcharts](http://code.highcharts.com/mapdata/). |
   | Parent | Select a parent map for this map. The parent-child relationships define drill levels in a map hierarchy. |
   | Active | Clear this check box to make the map unavailable when creating map reports. |
   | Geographical map | If your map is not geographical, clear this check box. For example, clear this check box for a floor map. |
   [Table 1. Report Maps form]

   {#t_CreateAMap__table_fpx_yxx_bv} {#t_CreateAMap__step_bw1_wzn_1z}
{#t_CreateAMap__step_bw1_wzn_1z}
3. Right-click the form header and select Save. {#t_CreateAMap__step_x5t_zd4_1z}
{#t_CreateAMap__step_x5t_zd4_1z}
4. To add conditions that filter the data in the map:
   1. Click New in the Map conditions related list.
   2. Fill in these fields.  
      {#t_CreateAMap__table_lxq_f1w_y5__entry__2}

      | Field | Description |
      |-|-|
      | Active | Select this check box to apply this condition. |
      | Table | Specify the table that these conditions apply to. Conditions cannot be shared across tables. |
      | Map source | Select the map source that the condition applies to. |
      | Conditions | Add filter conditions to apply to this map. |
      [Table 2. Map condition form]

      {#t_CreateAMap__table_lxq_f1w_y5}
   3. Click Submit.
   {#t_CreateAMap__substeps_rpq_xwb_mv} {#t_CreateAMap__step_lyz_zd4_1z}
{#t_CreateAMap__step_lyz_zd4_1z}
5. **Optional:** In the Report Maps related list, create a child map to extend the map hierarchy. {#t_CreateAMap__step_d21_yzn_1z}
{#t_CreateAMap__step_d21_yzn_1z}
6. Click Update to save the map. {#t_CreateAMap__step_tlj_yzn_1z}
{#t_CreateAMap__step_tlj_yzn_1z}
**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 key-value pair mapping](https://servicenow-prod.fluidtopics.net/Fy3cMQPmZ3XW3gqbRvBomQ "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.")

## Set the default map for map reports {#ariaid-title2}

You can change the map that appears by default in the Set map
field when you create a map report.

### Before you begin

Role required: admin or report_admin.

### Procedure

1. Navigate to AllReportsAdministrationProperties.
2. In the Set the default map for reports of type 'Map' field, type the key of the map that you want to set as default.  
   You can find a list of maps under ReportsAdministrationMaps.
3. Click Save.

*[\>]: and then