Usage Insights for Pareto bar visualizations

reference brazil Updated Sep 10, 2026 5 min read config-dv-pareto-uxa-data.md
Raw file servicenow.com

When you select a Usage Insights data source for a Pareto bar visualization the following Data configuration options are available.

Important: Pareto visualizations are only suitable for Events data, not Users or Sessions. Only Events have a value to group by.

Field

Description

Data

Data source

You have selected a Usage Insights data source in Create a horizontal or vertical bar data visualization.

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.

Note: Only one data source can be defined for pareto visualizations at any given time.

Metric

Label

Label of the metric. By default it is the same as the name of the data source.Note: Only one metric can be defined for a Pareto bar visualization at any given time.

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

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

Group by

Event property

Properties of the Usage Insights data source.

Note: Available only for Events and Sessions metrics, in which case it is mandatory.

Add alternative group by

This selection opens a dialog in which you select additional items that the data in the visualization may be grouped by. The viewer of the visualization can then select which of these items to group the data by. The viewer toggles the visibility of the selector in the visualization's More actions menu. In the additional items dialog, you can set whether this selector is visible by default by toggling Selector visible by default.If you select a value in Group by, that is the default group-by value. You don't have to select a Group by value to specify alternative group-by values. In this case, no default group-by value is used.

Data snapshots indicators support only reference, Boolean, and choice fields for alternative group bys.

For more information about setting alternative group-bys for multiple metrics, see Options for time series data visualizations with multiple metrics. For more information about the viewer experience selecting from alternative group-by values, see Select a group-by value in a data visualization as a viewer.

Important:

  • Only up to three metrics on one visualization support alternative group-by.
  • Alternative group-by does not support data binding on the data source

Date range

Show data for selected period as

Available when Apply date range is selected.The indicator aggregation logic for how scores from the selected period are shown, such as Latest score, Sum, or Average.

Set absolute period

Option to set absolute start and end date.Available when Apply date range is selected.

Period start

Start date for the absolute period.This property applies only when Set absolute period is true.

Period end

End date for the absolute period.This property applies only when Set absolute period is true.

Select Use current date for period end to automatically update the end date to the current date. (Not available if the start date is in the future.)

Period

Time interval for each date period. - Days D

  • Weeks W
  • Months M
  • Quarters Q
  • Years Y

The available periods depend on the time aggregation. A period can't be shorter than the time aggregation unit. If you change the time aggregation to a longer unit than the selected period, the period changes to the shortest period that is still available.

This property applies only when Set absolute period is false.

Number of periods

Number of date periods to display. This property applies only when Set absolute period 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.

Content

Secondary text of the message that provides additional detail.

Alignment

The alignment of the illustration and text in the message.

**Parent Topic:**[Create a Pareto bar data visualization](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/create-dv-pareto-vd.md)
Search documentation
Search document titles and file paths on the brazil branch