---
sourceDocument: Zurich Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/now-intelligence

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Pie and donut visualizations

# Create a pie or donut data visualization {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes to read

Use pie, donut, and semi-donut visualizations to compare the size of parts of a data set to the whole. The segments of these visualizations should total to 100%.

## 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/oHeVpceyt562Dg2ZHiuRfg "The report_view operation is a record type access control list (ACL) that restricts access to reports. Only users who have one of the required roles can view reports that contain the restricted resource.") and [Platform Analytics roles](https://www.servicenow.com/docs/xiuMpeQbmOsrX8S3pNeoaw "Platform Analytics has both unique roles and roles from other applications that apply to it.").

For more information about this visualization type, see [Pie/Donut Visualization Overview](https://developer.servicenow.com/dev.do#!/reference/now-experience/xanadu/shared-components/now-vis-pie-wrapper/overview) on the
ServiceNow
Developer Site.

## About this task

For information about the use of a Pie, Donut, or Semi-donut visualization in a dashboard, see [the Developer Site](https://developer.servicenow.com/dev.do#!/reference/now-experience/xanadu/shared-components/now-vis-pie-wrapper/usage). This site gives information about Pie and donut data visualization components in the UI Builder, and some configuration options may differ from the Visualization Designer.

## Procedure

1. Navigate to AllPlatform AnalyticsLibraryData Visualizations, or open an in-line dashboard and select Edit. {#create-dv-donut-ac__ph_yvn_xvt_4tb}
2. Select Create data visualization. {#create-dv-donut-ac__ph_mdy_zvt_4tb}
3. Select the pie (![Pie visualization icon]()), donut (![donut icon]()), or semi-donut (![Data visualization semi-donut icon]()) visualization type.
4. Configure the Header and border. Header and border options are the same for all data sources.  
   {#create-dv-donut-ac__table_ly5_djk_c5b__entry__2}{#create-dv-donut-ac__ac-dv-showheader}{#create-dv-donut-ac__ac-dv-showheadersep}{#create-dv-donut-ac__ac-dv-charttitle}{#create-dv-donut-ac__ac-dv-chartdesc}{#create-dv-donut-ac__ac-dv-wraptitle}{#create-dv-donut-ac__ac-dv-wraplabels}{#create-dv-donut-ac__ac-dv-maxlabelsize}{#create-dv-donut-ac__ac-dv-truncationtype}{#create-dv-donut-ac__ac-dv-showborder}{#create-dv-donut-ac__ac-dv-bare}{#create-dv-donut-ac__ac-dv-showrefreshoption}{#create-dv-donut-ac__ac-dv-show-export-option}

   | Header and border fields | Description |
   |-|-|
   | 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. |
   | 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. |
   | Truncation type | Specify where to truncate long labels with an ellipsis. Options are Beginning, Middle, and End. |
   | Show border | Option to display a line around the component. |
   | 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 always 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-donut-ac__table_ly5_djk_c5b} {#create-dv-donut-ac__ph_m1w_vwt_4tb}
5. Choose a data source.  
   For general descriptions of the data sources, see [Data sources for data visualizations](https://www.servicenow.com/docs/M~B1gCmTorIHHfQPqZSZlA "Each workspace data visualization references a specific data source.").
   * Table (available in the base system). When you select a table, you can filter it by custom or preconfigured conditions. Custom conditions can include questions or Service Catalog variables.{#create-dv-donut-ac__table-data-source}

     Configured report sources appear in the Predefined conditions list. For more information, see [Report sources](https://www.servicenow.com/docs/LOVLFgWYEJppbrPEAWILSg#c_ReportSources "Report sources are predefined data sets for creating reports.").  
     To help you create a custom filter, there is a preview list of records that would be included in the visualization. You can change which fields are shown as columns and the width of columns in the list actions.  

   * Indicator (available in the base system). You can filter the indicator scores by breakdowns and elements.  
     Note:  
     Benchmark indicators are not supported.

     <br />

     Note:  
     You might have a multiple select (is one of) or dynamic (is (dynamic)) operator on the breakdown element filter. These operators require the indicator and breakdown to support them. For more information about the
     configurations that support these operators, see ["Is one of" and "Is (Dynamic)" operators on breakdown conditions in data visualizations](https://www.servicenow.com/docs/gdupUIVbjBjfr77i4ROCFw#condition-operators-ind-bkdowns__section_breakdown-operators).
   * Usage Insights (available with the User Experience PAR Integration application, to users with a required role). Choose one of up to three KPIs included with this application, depending on the visualization type. For more information, see [User Experience Analytics data sources for data visualizations](https://www.servicenow.com/docs/bG_rVQjTK7~~rW4KWetfhA "You can show metrics related to Usage Insights in a data visualization component. The available metrics depend on the visualization type.").
6. Select the options for your data source.  
   * If your visualization represents table data, go to [Table data options for pie and donut visualizations](https://www.servicenow.com/docs/v4ty6wNj7gPkMoFqvVVENQ "When you select a table data source for a pie or donut visualization, the following Data configuration options are available.").
   * If your visualization represents indicator data, go to [Indicator data options for pie and donut visualizations](https://www.servicenow.com/docs/uhaSrDKEv5vh6DHIC0pBjA "When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available.").
   * If your visualization represents Usage Insights data, go to [Usage Insights data options for pie and donut visualizations](https://www.servicenow.com/docs/m4MgheU2CNWoxwtwzCIzbg "When you select a Usage Insights data source for a pie or donut visualization, the following Data configuration options are available.")
   {#create-dv-donut-ac__ul_zcw_w5s_qtb}
7. Under Presentation, provide display and color information.  
   {#create-dv-donut-ac__table_gvk_2mr_qtb__entry__2}

   | Field | Description |
   |-|-|
   | Display settings ||
   | Show data table | Shows a table with chart and graph data for easier screen reader access. Data includes the percentage of the total for each value, when appropriate. |
   | Show % of total in tooltip | Enable to show the percentage each data point contributes to the total alongside absolute values in the tooltip. |
   | Legend ||
   | Show legend | Option to display the legend. Activated automatically at 400% zoom. |
   | Show legend value | Option to display the value corresponding to the area of the chart you hover on. The value displays as a tooltip and in the chart legend. |
   | 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-donut-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. |
   | Expand legend vertically | When turned on, the legend contents take as much space as needed to fit the legend without scrolling, instead of the maximum 2 lines. |
   | Data label ||
   | Show data labels | Option to display the score for each data point. |
   | Colors ||
   | Set color type | Type of color scheme to apply to the component. Options include: * Default: A color or set of colors that come from the UX Theme that is applied to the instance. For more information, see [Working with themes in Next Experience](https://www.servicenow.com/docs/access?context=next-experience-theming&version=zurich&pubname=zurich-platform-user-interface&ft:locale=en-US). * Color palette: List of color palettes to select from predefined system palettes in the Chart Color Scheme \[pa_chart_color_schemes\] table. For grouped or stacked data, the colors apply in order from highest value to lowest. For multiple data sources, palette colors apply in the order of data sources. For example, the first color of a palette applies to the first data source, and the second palette color applies to the second source. All visualizations that use the same color palette show the same colors, regardless of what data they display. * Fixed element color: Use a specific color from the Chart Colors table \[sys_report_chart_color\] for each element. All data visualizations that use fixed element colors show the same element, such as critical incidents in the Global scope, in the same color. This option is available only for Table data sources and only if no more than one data source or metric is added, and a Group by is defined. |
   [ ]

   {#create-dv-donut-ac__table_gvk_2mr_qtb}
8. Under Chart interaction, set what if anything happens when a viewer clicks a chart or a chart segment on the visualization.  
   {#create-dv-donut-ac__table_qnp_d2d_b1c__entry__2}

   | Field | Description |
   |-|-|
   | Allow chart interaction | Enable an event to occur when a user clicks in a visualization or one of its segments. |
   | Action | Choose the event that occurs when a user clicks 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/nyVXfxliOP7lNpl37zAYLQ "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/4j6LFUv6cFaaAhuHX2fh8w "When the chart interaction for a data visualization is set to Go to data, interacting with a data value on the visualization opens different pages depending 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. * Apply as filter filters all data visualizations on the dashboard by the value of the selected segment, where applicable. Note: Apply as filter is available only for table and indicator data sources. It does not work when the Group by field is a duration field. * 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 do not open in Workspace embedded lists. Drill down to chart supports only table data sources. |
   [Table 1. Chart interaction]

   {#create-dv-donut-ac__table_qnp_d2d_b1c}
9. Select Save.  
   Navigate to AllPlatform AnalyticsLibraryData Visualizations to return to the Data Visualization list.
{#create-dv-donut-ac__steps_gj3_4ry_5r}

## What to do next

* [Add a visualization to a dashboard from the Visualization Designer](https://www.servicenow.com/docs/gvg6K~VChltcsrcCdob~XQ "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/yVacG3WThqkMMP3~CYuIgA#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/btqS6ZBHRfeCOSUdGZGQ8Q "Bookmark a visualization so that you can find it easily in the Data Visualizations library.")
{#create-dv-donut-ac__ul_bz5_byk_qtb}
* **[Table data options for pie and donut visualizations](https://www.servicenow.com/docs/v4ty6wNj7gPkMoFqvVVENQ)**   
  When you select a table data source for a pie or donut visualization, the following Data configuration options are available.
* **[Indicator data options for pie and donut visualizations](https://www.servicenow.com/docs/uhaSrDKEv5vh6DHIC0pBjA)**   
  When you select an indicator data source for a pie or donut visualization, the following Data configuration options are available.
* **[Usage Insights data options for pie and donut visualizations](https://www.servicenow.com/docs/m4MgheU2CNWoxwtwzCIzbg)**   
  When you select a Usage Insights data source for a pie or donut visualization, the following Data configuration options are available.
* **[Pie visualization example](https://www.servicenow.com/docs/J~CamcsetcDSsCE4LEF7PA)**   
  The pie data visualization uses a circular shape to show the proportion or percentage of different categories or groups. Each part of the circle (or "slice") represents a different category or group, and the size of each slice is proportional to the size of the group or category it represents.
* **[Donut visualization example](https://www.servicenow.com/docs/RlKXGpuxlLDsvenJcSOGtQ)**   
  The donut visualization uses a hollow circular shape to show the proportion or percentage of different categories or groups. The semi-donut visualization does the same job as the donut using a semicircle instead of a full circle.

*[\>]: and then