---
sourceDocument: Brazil Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/now-intelligence

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Geomap visualizations

# Create a geomap data visualization {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read  
A geomap visualization shows the geographical distribution of data for a world, country, region, or province/state. Use Geomaps to show table data that contains location information.

## Before you begin

Role required: Anyone with access to data can create a visualization of that data on any dashboard that they can edit. Users with the itil, report_user, admin, or viz_creator role can create a visualization in the Visualization Designer. When you create a visualization in the Visualization Designer, it is saved to the Library. For more information on access, see [Report_view access control](https://www.servicenow.com/docs/8n9OBOfn~tEm2c3Rc8uYFQ "The report_view operation is a record type ACL that restricts access to data visualizations and Core UI reports. Only users who have one of the required roles can view visualizations that contain the restricted resource.") and [Platform Analytics roles](https://www.servicenow.com/docs/9DexzqdJbtnHOvqfQwdBqg "Platform Analytics has both unique roles and roles from other applications that apply to it.").

## About this task

For information about the use of a Geomap visualization in a dashboard, see [the Developer Site](https://developer.servicenow.com/dev.do#!/reference/next-experience/vancouver/shared-components/now-vis-geomap-wrapper/usage). This site gives information about Geomap data visualization components in the UI Builder, and some configuration options may differ from the Visualization Designer.

## Procedure

1. Navigate to AllPlatform AnalyticsLibraryData Visualizations, or open an in-line dashboard and select Edit. {#create-dv-geomap-ac__ph_yvn_xvt_4tb}
2. Select Create data visualization. {#create-dv-geomap-ac__ph_mdy_zvt_4tb}
3. Select the Geomap visualization type. {#create-dv-geomap-ac__ph_afq_5wt_4tb}
{#create-dv-geomap-ac__step_sk1_5wt_4tb}
4. Choose a table data source.  
   For general descriptions of the data sources, see [Data sources for data visualizations](https://www.servicenow.com/docs/3~kiOg2G6sd0qikGDIomuQ "Each workspace data visualization references a specific data source.").
   1. Configure the map settings.
   2. Enable drill-down to enable or disable map navigation between levels and list redirection.
   {#create-dv-geomap-ac__substeps_mxk_5rg_kxb} {#create-dv-geomap-ac__step_pzv_bgs_qtb}
{#create-dv-geomap-ac__step_pzv_bgs_qtb}
5. Configure the Header and border. Header and border options are the same for all data sources.  
   {#create-dv-geomap-ac__table_ly5_djk_c5b__entry__2}{#create-dv-geomap-ac__ac-dv-showheader}{#create-dv-geomap-ac__ac-dv-showheadersep}{#create-dv-geomap-ac__ac-dv-charttitle}{#create-dv-geomap-ac__ac-dv-chartdesc}{#create-dv-geomap-ac__ac-dv-wraptitle}{#create-dv-geomap-ac__ac-dv-showborder}{#create-dv-geomap-ac__ac-dv-bare}{#create-dv-geomap-ac__ac-dv-show-refresh}

   | Header and border fields | Description |
   |-|-|
   | Show header | The visualization header, including title and icons. |
   | Show header separator | Option to display a line separating the header from the rest of the component. |
   | Chart title | Title of the visualization. |
   | Title alignment | Choose Start to align the title with the start of line, End to align it with the end of the line, or Center for center alignment. |
   | Description | A short overview about the visualization that the end user sees. Descriptions help users find the visualization. |
   | Wrap title | Option to wrap long titles onto a second line. If false, displays an ellipsis to truncate long titles. |
   | Line of truncation | Specify where to truncate long labels with an ellipsis. Options are 1, 2, and 3. |
   | Show border | Option to display a line around the component. |
   | Bare | Option to remove padding around data visualization to provide more compact positioning on the page. Only available when Show border is turned off. |
   | Show refresh option | Option to show or hide the refresh option from data visualizations. If cache is enabled on a dashboard, the Refresh option is hidden. |
   [ ]

   {#create-dv-geomap-ac__table_ly5_djk_c5b} {#create-dv-geomap-ac__ph_m1w_vwt_4tb}
{#create-dv-geomap-ac__step_av3_vwt_4tb}
6. Set the options for your data source.  
   Go to [Table data options for Geomap visualizations](https://www.servicenow.com/docs/akbxIUn20YOjCNzYHOFj4Q "When you select a table data source for a Geomap visualization, the following Data configuration options are available.").
7. Under Presentation, provide display and color information.  
   {#create-dv-geomap-ac__table_czj_b1d_zxb__entry__2}{#create-dv-geomap-ac__ac-dv-sortby}{#create-dv-geomap-ac__ac-dv-sortbyorder}

   | Field | Description |
   |-|-|
   | Show data table | Shows a table with chart and graph data for easier screen reader access. Data includes the percentage of the total for each value, when appropriate. |
   | Show % of total in tooltip | Enable to show the percentage each data point contributes to the total alongside absolute values in the tooltip. |
   | Map | Map to plot the data, such as the world map or the map of a country. |
   | Show data label | Enables the data labels. |
   | Legend | Displays the legend. |
   | Legend position | Legend location in relation to the visualization. Options include: * Above * Below * Right * Left {#create-dv-geomap-ac__ul_bns_zxg_kxb} |
   | Set color type | Type of color scheme to apply to the component. The choices are: * Default: A color or set of colors that come from the UX Theme that is applied to the instance. For more information, see [Working with themes in Next Experience](https://www.servicenow.com/docs/access?context=next-experience-theming&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). * Color range: A spectrum of colors between a color for the lowest value and a color for the highest value. You can select these colors from a set of icons, from a list of colors including their icons, or by searching for the color name or hexadecimal value. The colors are taken from the Color Definition \[sys_report_color\] table. |
   [ ]

   {#create-dv-geomap-ac__table_czj_b1d_zxb}
8. Under Chart interaction, set what if anything happens when a viewer selects a chart or a chart segment on the visualization.  
   {#create-dv-geomap-ac__table_qnp_d2d_b1c__entry__2}

   | Field | Description |
   |-|-|
   | Allow chart interaction | Enable an event to occur when a user selects a visualization or one of its segments. |
   | Action | Only the Go to data view interaction is available for geomaps. This action opens the underlying records view. |
   [ ]

   {#create-dv-geomap-ac__table_qnp_d2d_b1c}
9. Select Save to continue editing the visualization, or Save and close to return to the Analytics Overview main screen. {#create-dv-geomap-ac__select-save}
{#create-dv-geomap-ac__select-save}{#create-dv-geomap-ac__steps_v5g_kq2_xwb}

## What to do next

* [Add a visualization to a dashboard from the Visualization Designer](https://www.servicenow.com/docs/HVO4E0xJs1Lz1bd9cXFp4w "Add a visualization from the Visualization Designer to a new dashboard or to an existing dashboard.")
* [Share a data visualization in the Visualization Designer](https://www.servicenow.com/docs/WbX_Y9sh34~cI7PHSFJx0w#share-dv-ac "Share a visualization to provide view or edit permissions to users, groups, or roles. A user can access a shared visualization in any workspace on the original instance.")
* [Bookmark a visualization in the Visualization Designer](https://www.servicenow.com/docs/6FO19Qnm34p6n99BHgKZ1g "Bookmark a visualization so that you can find it easily in the Data Visualizations library.")
{#create-dv-geomap-ac__ul_bz5_byk_qtb}
* **[Table data options for Geomap visualizations](https://www.servicenow.com/docs/akbxIUn20YOjCNzYHOFj4Q)**   
  When you select a table data source for a Geomap visualization, the following Data configuration options are available.
* **[Map sources for geomap data visualizations](https://www.servicenow.com/docs/OX0f2Moqw5P0_bcds_lTeg#geomap-map-source)**   
  Geomap data visualizations are connected to location tables in a special map source.

*[\>]: and then