Usage Insights data options for dial data visualizations

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read

    • When you select a Usage Insights data source for a dial visualization, the following Data configuration options are available.

    Field Description

    Data source

    You have selected a Usage Insights data source in Create a dial data visualization.
    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 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
    Date range
    Apply date range

    When turned on, this option allows date filters on the dashboard or UIB page to apply to this visualization. The date range can also be configured in the visualization, but date filters override visualization settings.
    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
    • Months M
    • Years Y

    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.

    Additional settings
    Show metric label Option to show the metric label. In donut charts, the value is not shown if it cannot fit the donut.
    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.