Indicator data options for pie and donut visualizations
When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available.
Note: Fields that apply to Data snapshots indicators apply only to native Data snapshots indicators, not classic indicators with Data snapshots enabled.
The data source for a native Data snapshots indicator has the indicator type Automated - Data Snapshots or Formula - Data Snapshots.
[Omitted image "ds-source-native.png"] Alt text: Data source properties for a native Data snapshots indicator
The data source for a classic indicator with Data snapshots enabled has the indicator type of either Automated or Formula.
[Omitted image "ds-source-enabled.png"] Alt text: Data source properties for an enabled Data snapshots indicator
|
Field |
Description |
|---|---|
|
Data | |
|
Data source |
You have selected an Indicator data source in Create a pie or donut data visualization. |
|
Metric | |
|
Label |
Label of the metric. By default it is the same as the name of the data source. |
|
Time aggregation |
Time aggregation to apply to the metric, such as 7-day running SUM or By-month AVG. Default is the same as the indicator period. For more information, see Applying time series aggregations. |
|
Select an aggregation (Data snapshots indicators only) |
The aggregation is based on the Data snapshots indicator's configuration. You can't change it in the context of creating a data visualization. Count counts the number of records. Count distinct counts the number of unique values rather than the total number of records. For example, if the name of a user appears more than once in a list, the user is only counted once. Other choices perform the specified aggregate operation, such as summing the values in a field across records. |
|
Field (Data snapshots indicators only) |
The field on the Data snapshot's source to which the aggregate is applied. Required for all aggregates except Count. |
|
Show incomplete periods (Data snapshots indicators only) |
Select to display values from the period in progress. Clear this check box to show only the values for completed periods. |
|
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 |
|
Group by | |
|
Breakdown |
List of breakdowns to choose from for grouping indicator scores.Important:
Each breakdown element is shown separately in the visualization. If a multiple select filter for that breakdown is also applied to the visualization, only the selected elements are shown. If you do not specify a breakdown in this field and apply a multiple select filter, the aggregate score of all selected breakdown elements is shown. For more information, see Viewing multiple breakdown elements. Data snapshots indicators support only reference, Boolean, and choice fields for group bys. Note: For Data snapshots indicators, breakdowns are specified on the indicator source. For classic Performance Analytics indicators, breakdowns are specified on the indicator record. |
|
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:
|
|
Sorting | |
|
Sort by |
Sorting options of the main and alternative groups set in Group by. Options include:- Name: Sorts the values alphabetically by field or element name.
Note:
|
|
Sort by order |
Ascending or descending. |
|
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
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. |
|
Additional settings | |
|
Show total value |
Option to show the overall total value. Value is still hidden if it does not fit in the donut, due to width/height settings, page resizing, or similar issues. Clicking the total value opens a list of contributing table records or KPI Details for the indicator. |
|
Show metric label |
Option to show the metric label. In donut charts, the value is not shown if it can't 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. |
--- title: Indicator data options for pie and donut visualizations description: When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available. locale: en-US canonical_url: https://www.servicenow.com/docs/r/now-intelligence/config-dv-donut-ind-data.html release: brazil topic_type: reference last_updated: "2026-09-10" reading_time_minutes: 9 breadcrumb: [Pie and donut visualizations, Create, Data visualizations, Platform Analytics experience, Platform Analytics] --- # Indicator data options for pie and donut visualizations When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available. **Note:** Fields that apply to Data snapshots indicators apply only to native Data snapshots indicators, not classic indicators with Data snapshots enabled. The data source for a native Data snapshots indicator has the indicator type **Automated - Data Snapshots** or **Formula - Data Snapshots**. \[Omitted image "ds-source-native.png"\] Alt text: Data source properties for a native Data snapshots indicator The data source for a classic indicator with Data snapshots enabled has the indicator type of either **Automated** or **Formula**. \[Omitted image "ds-source-enabled.png"\] Alt text: Data source properties for an enabled Data snapshots indicator <table id="table_wqy_sjr_qtb"><thead><tr><th> Field </th><th> Description </th></tr></thead><tbody><tr><td class="sub-head" id="heading-data" colspan="2"> Data </td></tr><tr><td> Data source </td><td> You have selected an Indicator data source in [Create a pie or donut data visualization](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/create-dv-donut-ac.md). </td></tr><tr><td class="sub-head" colspan="2"> Metric </td></tr><tr><td> Label </td><td> Label of the metric. By default it is the same as the name of the data source. </td></tr><tr><td> Time aggregation </td><td> Time aggregation to apply to the metric, such as 7-day running SUM or By-month AVG. Default is the same as the indicator period. For more information, see [Applying time series aggregations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/performance-analytics/applying-time-series-aggregations.md). </td></tr><tr><td> Select an aggregation \(Data snapshots indicators only\) </td><td> The aggregation is based on the Data snapshots indicator's configuration. You can't change it in the context of creating a data visualization. **Count** counts the number of records. **Count distinct** counts the number of unique values rather than the total number of records. For example, if the name of a user appears more than once in a list, the user is only counted once. Other choices perform the specified aggregate operation, such as summing the values in a field across records. </td></tr><tr><td> Field \(Data snapshots indicators only\) </td><td> The field on the Data snapshot's source to which the aggregate is applied. Required for all aggregates except Count. </td></tr><tr><td> Show incomplete periods \(Data snapshots indicators only\) </td><td> Select to display values from the period in progress. Clear this check box to show only the values for completed periods. </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/brazil/markdown/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"> Group by </td></tr><tr><td> Breakdown </td><td> List of breakdowns to choose from for grouping indicator scores.**Important:** - Scripted breakdowns aren't supported in dashboard filters. - Only two levels of breakdown are supported in total, including data visualization and dashboard filters. Each breakdown element is shown separately in the visualization. If a multiple select filter for that breakdown is also applied to the visualization, only the selected elements are shown. If you do not specify a breakdown in this field and apply a multiple select filter, the aggregate score of all selected breakdown elements is shown. For more information, see [Viewing multiple breakdown elements](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/performance-analytics/view-multiple-breakdown-elements.md). Data snapshots indicators support only reference, Boolean, and choice fields for group bys. **Note:** For Data snapshots indicators, breakdowns are specified on the indicator source. For classic Performance Analytics indicators, breakdowns are specified on the indicator record. </td></tr><tr><td> Add alternative group by </td><td> 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/chart-options-multi-metrics.md). 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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/select-group-runtime.md). **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 </td></tr><tr><td class="sub-head" colspan="2"> Sorting </td></tr><tr><td> Sort by </td><td> Sorting options of the main and alternative groups set in **Group by**. Options include:- Name: Sorts the values alphabetically by field or element name. - Value: Sorts the values numerically or by count. - Element order: Sorts the groups according to the value of the Sequence field. Available when grouping by records on the Choice \[sys\_choice\] table, either directly or through a breakdown. - Group bucket: Sorts the elements by bucket group, when applicable. Only available for indicator data sources and when the breakdown used for the **Group by** is based on a bucket group. - Report range: Sorts the table field values by range. Only available for table data sources and when the table field used for the **Group by** has a report range associated with it. **Note:** - The choices of what to sort by are based on the main, default **Group by**, if one is defined. This sorting applies to any alternative group-bys if possible. If the sorting criterion selected for the main group-by can't apply to an alternative group-by, sorting defaults to Value. For example, sorting by Element order when the alternative group-by is not on the Choice table. - If no main **Group by** has been set, but alternative group-bys are defined, you can sort only by Name or Value. - Sorting is not available for Pareto bar visualizations. Pareto charts are always sorted by value in descending order. </td></tr><tr><td> Sort by order </td><td> Ascending or descending. </td></tr><tr><td class="sub-head" colspan="2"> Date range </td></tr><tr><td> Apply date range </td><td> 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. </td></tr><tr><td> Show data for selected period as </td><td> 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. </td></tr><tr><td> Set absolute period </td><td> Option to set absolute start and end date.Available when **Apply date range** is selected. </td></tr><tr><td> Period start </td><td> Start date for the absolute period.This property applies only when **Set absolute period** is true. </td></tr><tr><td> Period end </td><td> 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.\) </td></tr><tr><td> Period </td><td> 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. </td></tr><tr><td> Number of periods </td><td> Number of date periods to display. This property applies only when **Set absolute period** is true. </td></tr><tr><td class="sub-head" colspan="2"> Additional settings </td></tr><tr><td> Show total value </td><td> Option to show the overall total value. Value is still hidden if it does not fit in the donut, due to width/height settings, page resizing, or similar issues. Clicking the total value opens a list of contributing table records or KPI Details for the indicator. </td></tr><tr><td> Show metric label </td><td> Option to show the metric label. In donut charts, the value is not shown if it can't fit the donut. </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 pie or donut data visualization](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/now-intelligence/create-dv-donut-ac.md)
| title | Indicator data options for pie and donut visualizations |
| description | When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/now-intelligence/config-dv-donut-ind-data.html |
| release | brazil |
| topic_type | reference |
| last_updated | 2026-09-10 |
| reading_time_minutes | 9 |
| breadcrumb | Pie and donut visualizationsCreateData visualizationsPlatform Analytics experiencePlatform Analytics |