Usage Insights data options for gauge visualizations
When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available.
Note: If you add a Platform Analytics data visualization with Usage Insights data to an inline dashboard, the default drilldown for that data visualization is to open the corresponding UXA analytics page. This feature provides a quick and efficient way to drill down and explore specific user behavior from your Platform Analytics dashboard.
|
Field |
Description |
|---|---|
|
Data source |
You have selected a Usage Insights data source in Create a gauge data visualization in the Visualization Designer. |
|
Metric | |
|
Metric |
Label of the metric. By default it is the same as the name of the data source: Events or Sessions.For sessions, you can configure the metric to reflect the number of sessions, average session duration, average pages per session, or average sessions per user. |
|
Format values |
Select to open the Formatting values dialog. For more information, see Value formatting in reports. |
|
Formatting values | |
|
Use custom formatting |
Option to use custom formatting on the component. |
|
Decimal precision |
Number of decimals to show in the metric. This field is available only when the Use custom formatting option is activated. |
|
Rounding |
Type of rounding to use to reach the number of decimals in the Decimal precision field. Options include:- Up
Note: Only available when Use custom formatting is true. |
|
Use the thousands group separator |
Option to use a comma to separate groups of thousands.Note: Only available when Use custom formatting is true. |
|
Enable abbreviation |
Option to use an alphabetical abbreviation. For example, M to represent million. Note: Only available when Use custom formatting is true. |
|
Example |
Example of the final value to show in the component. Note: Only available when Use custom formatting is true |
|
Data update | |
|
Follow filters |
Follow filters set for a page. When enabled, the visualization displays on a workspace with the filters set by the page. Toggle off to disable a visualization from accepting any filter input. |
|
Show filter icon |
Option to show the filter icon and the number of filters impacting the visualization. If a filter is not selected to apply to a visualization, the icon does not show. Toggle off to hide the filter icon and number of filters applied. |
|
Refresh after being away for X min. |
Triggered when you navigate away from the dashboard that contains the data visualization to another page in the same workspace, includingPlatform Analytics experience. Sets how many minutes you will be on another page before the visualization automatically refreshes when you navigate back.Do not confuse this property with the Scheduled repetition setting on inline dashboards. This latter property refreshes the entire dashboard, and applies only while that dashboard is open. |
|
Info messages | |
|
Set custom message when no data |
Option to configure a custom message that displays when no data is returned. |
|
Illustration |
An illustration to include in the message. |
|
Heading |
Header text of the message that describes why no data was returned. |
|
Heading level |
Header text size for the message that describes why no data was returned. |
|
Content |
Secondary text of the message that provides additional detail. |
|
Alignment |
The alignment of the illustration and text in the message. |
--- title: Usage Insights data options for gauge visualizations description: When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/now-intelligence/config-dv-gauge-uxa-data.html release: australia topic_type: reference last_updated: "2026-09-10" reading_time_minutes: 3 breadcrumb: [Gauge visualizations, Create, Data visualizations, Platform Analytics experience, Platform Analytics] --- # Usage Insights data options for gauge visualizations When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available. **Note:** If you add a Platform Analytics data visualization with Usage Insights data to an inline dashboard, the default drilldown for that data visualization is to open the corresponding UXA analytics page. This feature provides a quick and efficient way to drill down and explore specific user behavior from your Platform Analytics dashboard. <table id="table_wqy_sjr_qtb"><thead><tr><th> Field </th><th> Description </th></tr></thead><tbody><tr><td> Data source </td><td> You have selected a Usage Insights data source in [Create a gauge data visualization in the Visualization Designer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/create-dv-gauge-ac.md). </td></tr><tr><td class="sub-head" colspan="2"> Metric </td></tr><tr><td> Metric </td><td> Label of the metric. By default it is the same as the name of the data source: Events or Sessions.For sessions, you can configure the metric to reflect the number of sessions, average session duration, average pages per session, or average sessions per user. </td></tr><tr><td> Format values </td><td id="entry_format-values"> Select to open the **Formatting values** dialog. For more information, see [Value formatting in reports](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/reporting/value-formatting-reports.md). </td></tr><tr><td class="sub-head" colspan="2"> Formatting values </td></tr><tr><td> Use custom formatting </td><td> Option to use custom formatting on the component. </td></tr><tr><td> Decimal precision </td><td id="entry_decimal-precision"> Number of decimals to show in the metric. This field is available only when the **Use custom formatting** option is activated. </td></tr><tr><td> Rounding </td><td> Type of rounding to use to reach the number of decimals in the **Decimal precision** field. Options include:- Up `UP` - Down `DOWN` - Ceiling `CEILING` - Floor `FLOOR` - Half up `HALF_UP` - Half down `HALF_DOWN` - Half even `HALF_EVEN` **Note:** Only available when **Use custom formatting** is true. </td></tr><tr><td> Use the thousands group separator </td><td> Option to use a comma to separate groups of thousands.**Note:** Only available when **Use custom formatting** is true. </td></tr><tr><td> Enable abbreviation </td><td> Option to use an alphabetical abbreviation. For example, M to represent million. **Note:** Only available when **Use custom formatting** is true. </td></tr><tr><td> Example </td><td> Example of the final value to show in the component. **Note:** Only available when **Use custom formatting** is true </td></tr><tr><td class="sub-head" colspan="2"> Data update </td></tr><tr><td> Follow filters </td><td> Follow filters set for a page. When enabled, the visualization displays on a workspace with the filters set by the page. Toggle off to disable a visualization from accepting any filter input. </td></tr><tr><td> Show filter icon </td><td> Option to show the filter icon and the number of filters impacting the visualization. If a filter is not selected to apply to a visualization, the icon does not show. Toggle off to hide the filter icon and number of filters applied. </td></tr><tr><td> Refresh after being away for X min. </td><td> Triggered when you navigate away from the dashboard that contains the data visualization to another page in the same workspace, includingPlatform Analytics experience. Sets how many minutes you will be on another page before the visualization automatically refreshes when you navigate back.Do not confuse this property with the **Scheduled repetition** setting on inline dashboards. This latter property refreshes the entire dashboard, and applies only while that dashboard is open. </td></tr><tr><td class="sub-head" colspan="2"> Info messages </td></tr><tr><td> Set custom message when no data </td><td> Option to configure a custom message that displays when no data is returned. </td></tr><tr><td> Illustration </td><td> An illustration to include in the message. </td></tr><tr><td> Heading </td><td> Header text of the message that describes why no data was returned. </td></tr><tr><td> Heading level </td><td> Header text size for the message that describes why no data was returned. </td></tr><tr><td> Content </td><td> Secondary text of the message that provides additional detail. </td></tr><tr><td> Alignment </td><td> The alignment of the illustration and text in the message. </td></tr></tbody> </table>**Parent Topic:**[Create a gauge data visualization in the Visualization Designer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/create-dv-gauge-ac.md)
| title | Usage Insights data options for gauge visualizations |
| description | When you select a Usage Insights data source for a gauge visualization, the following Data configuration options are available. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/now-intelligence/config-dv-gauge-uxa-data.html |
| release | australia |
| topic_type | reference |
| last_updated | 2026-09-10 |
| reading_time_minutes | 3 |
| breadcrumb | Gauge visualizationsCreateData visualizationsPlatform Analytics experiencePlatform Analytics |