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


---

# Gauge visualizations

# Create a gauge data visualization in the Visualization Designer {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes to read  
A gauge visualization shows where a value lies between expected minimum and maximum values. Use the gauge visualization to follow progress with color-coded value ranges.

## 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 Gauge visualization in a dashboard, see [the Developer Site.](https://developer.servicenow.com/dev.do#!/reference/now-experience/xanadu/shared-components/now-vis-gauge-wrapper/usage)

The site gives information about Gauge data visualization components in the UI Builder. Some configuration options may differ from the Visualization Designer.  
Note:  
Workflow Data Fabric sources don't support real-time update on single score, dial, and gauge visualizations.

## Procedure

1. Navigate to AllPlatform AnalyticsLibraryData Visualizations.
2. Select Create data visualization. {#create-dv-gauge-ac__ph_mdy_zvt_4tb}
3. Provide a name and useful description for the visualization and select Create data visualization.  
   The description enables users to find the visualization more easily in the library.
4. Select the Gauge (![]()) visualization type.
5. Select Add a 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.").

   The Suggested data sources are the indicators and tables you have recently selected.

   When you select a data source, you see a preview of the
   information in the source. Add conditions to the data source and then select Add this source.
6. Configure the Header and border. Header and border options are the same for all data sources.  
   None of the Header and border fields is required.{#create-dv-gauge-ac__table_ly5_djk_c5b__entry__2}{#create-dv-gauge-ac__ac-dv-showborder}{#create-dv-gauge-ac__ac-dv-showheader}{#create-dv-gauge-ac__ac-dv-showheadersep}{#create-dv-gauge-ac__ac-dv-charttitle}{#create-dv-gauge-ac__ac-dv-title-align}{#create-dv-gauge-ac__ac-dv-chartdesc}{#create-dv-gauge-ac__ac-dv-wraptitle}{#create-dv-gauge-ac__ac-dv-wraplabels}{#create-dv-gauge-ac__ac-dv-maxlabelsize}{#create-dv-gauge-ac__ac-dv-truncationtype}{#create-dv-gauge-ac__ac-dv-bare}{#create-dv-gauge-ac__ac-dv-showrefreshoption}{#create-dv-gauge-ac__ac-dv-show-export-option}

   | Header and border fields | Description |
   |-|-|
   | Show border | Option to display a line around the component. |
   | 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. |
   | Wrap labels | Select to wrap long elements labels on the axis. |
   | Max label size, px | Specify the maximum label size for element names on the axis. Default=100 px. |
   | Line of truncation | Specify where to truncate long labels with an ellipsis. Options are 1, 2, and 3. |
   | 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. |
   | Show export options | Option to show or hide the visualization's export types. |
   | Header background color | Specify the color behind the title of the visualization. |
   | Title color | Specify the text color of the title. The default title color is black, but you can choose a color that contrasts better with the header background. Only available when Header background color is selected. |
   [ ]

   {#create-dv-gauge-ac__table_ly5_djk_c5b} {#create-dv-gauge-ac__ph_m1w_vwt_4tb}
7. Configure the metric, data update, and no data message options for your data source.  
   * If your visualization represents table data, go to [Table data options for gauge data visualizations](https://www.servicenow.com/docs/RSwJDWHuhFg2EEHPCO5qKA "When you select a table data source for a gauge visualization, the following Data configuration options are available.").
   * If your visualization represents indicator data, go to [Indicator data options for gauge data visualizations](https://www.servicenow.com/docs/S4dLH6T_dgXLtDd1R6zcsg "When you select an indicator data source for a gauge visualization, the following Data configuration options are available.").
   * If your visualization represents Usage Insights data, go to [Usage Insights data options for gauge visualizations](https://www.servicenow.com/docs/PJgkZEucuOQgrki6JUPkRg "When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available.").
   {#create-dv-gauge-ac__ul_zcw_w5s_qtb}
8. Under Presentation, provide display and color information.  
   None of the Presentation fields is required.{#create-dv-gauge-ac__table_gvk_2mr_qtb__entry__2}

   | Field | Description |
   |-|-|
   | Display settings ||
   | Gauge arc angle | Choice of sizes for the gauge, in degrees. |
   | Value label size | Characters that represent dynamic sizes: small (S), medium (M), or large (L). The actual size of the type changes in proportion to the size of the chart. |
   | Inner radius | Specify the ratio of the visualization's inner radius to the outer. Allowed values are 0.7--0.95. |
   | Range ||
   | Min value | Set the lowest value shown on the visualization. If not specified, zero is the default. |
   | Max value | Set the highest value shown on the visualization. |
   | Configure ranges | Specify the number of ranges to divide the gauge into; default 3. You select the number of ranges, the start and end values of each range, the labels, and the color spectrum. |
   | Legend ||
   | Show legend | Option to display the legend. Activated automatically at 400% zoom. |
   | Legend position | Legend location relative to the chart: Above, Below, Right, or Left |
   | Legend orientation | Options for how to display the register. * Horizontal `horizontal`: Option to display the legend horizontally. * Vertical `vertical`: Option to display the legend vertically up to five lines. {#create-dv-gauge-ac__ul_yyv_stt_2rb} This property applies only when Legend position is Below. |
   | Horizontal alignment | Horizontal alignment of elements in the legend: Start, Center, or End |
   | Max legend item width, px | Number of pixels after which the item in the legend is truncated. |
   | Labels ||
   | Score label \[scoreLabel\] | The label of the score in the center of the gauge: * No label (None) * The same label as the visualization metric (Metric label) * The label that you set for the range that the score falls into, in Configure ranges (Range label) {#create-dv-gauge-ac__ul_mnr_2dv_fvb} Labels are disabled and replaced by legends at 400% zoom. |
   | Show range limit \[showRangeLimit\] | When true, the limits that you configured for the ranges are shown. If you did not configure any ranges, the default min and max values are shown. |
   | Show range labels \[showRangeLabels\] | When true, any labels you configured for ranges are shown. This property is available only if you configured ranges and specified labels for them. |
   | Show label as primary | Available when the score label is configured as Range label. Changes the places of the score value and label to make the score value small and emphasize the range value. |
   [ ]

   {#create-dv-gauge-ac__table_gvk_2mr_qtb}
9. Under Chart interaction, set what if anything happens when a viewer selects a chart or a chart segment on the visualization.  
   {#create-dv-gauge-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 | Choose the event that occurs when a user selects in a visualization or one of its segments. Choices depend on the visualization type and data source. Applies only when Allow chart interaction is on. For more information, see [Chart interactions in a data visualization](https://www.servicenow.com/docs/F6ZdH1epVHqK7QdFh34ADw "You can set what occurs when a user interacts with a visualization, such as by selecting a bar column. Possibilities include navigating to a URL, opening another data visualization, and filtering all visualizations on the dashboard by the selected value."). * Go to data view opens a list view, KPI Details page, or Usage Insights overview page relevant to the associated segment or visualization. For table data, a system property determines whether a Core UI list or a Platform Analytics list opens. For more information, see [Data views for different data sources](https://www.servicenow.com/docs/yA9xkXu4y~7Z3X4oIPMk2Q "Set the chart interaction for a data visualization to Go to data to open a data view. The page that opens depends on the data source."). * Go to URL opens the specified URL, which can be on the instance or external. You have the option of specifying a page name to appear in the tooltip, for those visualizations with tooltips. * Drill down to chart (Visualization Designer only) Opens a different data visualization that is filtered by the selected data. You can add a drill-down visualization for each metric on the parent visualization. Note: The last level of drill down in the Platform Analytics experience is always a Core UI list. Records don't open in Workspace embedded lists. Drill down to chart supports only table data sources. {#create-dv-gauge-ac__ul_ocy_fzy_ykc} |
   [ ]

   {#create-dv-gauge-ac__table_qnp_d2d_b1c}
10. Select Save to continue editing the visualization, or Save and close to return to the Analytics Overview main screen.
{#create-dv-gauge-ac__steps_gj3_4ry_5r}

## 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-gauge-ac__ul_bz5_byk_qtb}
* **[Table data options for gauge data visualizations](https://www.servicenow.com/docs/RSwJDWHuhFg2EEHPCO5qKA)**   
  When you select a table data source for a gauge visualization, the following Data configuration options are available.
* **[Indicator data options for gauge data visualizations](https://www.servicenow.com/docs/S4dLH6T_dgXLtDd1R6zcsg)**   
  When you select an indicator data source for a gauge visualization, the following Data configuration options are available.
* **[Usage Insights data options for gauge visualizations](https://www.servicenow.com/docs/PJgkZEucuOQgrki6JUPkRg)**   
  When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available.
* **[Gauge visualization example](https://www.servicenow.com/docs/OBIRqJQA58I~MXf9efxFjQ)**   
  Like dials, gauges show where a single value lies across a range from minimum to maximum expected values. In addition to dial functionality, you can set colored data ranges to help users understand what the value represents.

*[\>]: and then