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

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create a pie, donut, or semi-donut visualization for a breakdown widget

# Create a pie, donut, or semi-donut visualization for a breakdown widget {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read

To show the relative proportions of the elements of a breakdown, use a pie, donut, or
semi-donut visualization.

## Before you begin

Role required: pa_power_user or admin

## About this task

Note:  
This feature is part of the Core UI front end. It is not supported on Platform Analytics dashboards or UI Builder pages, except to a limited extent when migrated in compatibility mode. To build Platform Analytics components, see [Data visualizations in Platform Analytics](https://www.servicenow.com/docs/H75STRbAS_sjoXByLlY~Yw "Data Visualizations use graphics to show table, indicator, and other data. They combine and extend the functions of reports and Performance Analytics widgets from the Core UI, which they replace in Platform Analytics.") or [Filters in Platform Analytics](https://www.servicenow.com/docs/85ppWHBwO9IYCoc2jJZZNw "Filter lists and data visualizations on an inline or technical dashboard. Filter by possible data value, by whether the value is true or false, or by date.").

This feature is in maintenance mode and is no longer being augmented or changed. Only security fixes to this feature will be addressed.

When you need to compare the percentages or relative
proportions of breakdown elements, you can use a pie, a donut, or a semi-donut
visualization. Consider trying all three to see which works best for a particular
widget.

These visualizations can be unclear in the following cases:

* The breakdown has many elements.
* Several elements in the breakdown are much smaller than the others.

{#create-pie-widget__ul_rt2_yfn_v1b}

In these cases, or to compare scores instead of proportions, consider using a
column visualization.
Figure 1. Pie, donut, and semi-donut visualizations

## Procedure

1. Navigate to AllPerformance AnalyticsWidgets and click New.
2. In the Name field, give the widget a name that reflects the information being displayed.
3. In the Type field, select Breakdown.  
   If you change the value of Type after you fill in other fields, those fields are cleared.
4. In the Visualization field, select Pie, Donut, or Semi donut.  
   You can let the user switch between visualizations. Select Show visualization selector in the Display settings tab.
5. In the Indicator field, select the main indicator which you want to break down.
6. Select the breakdown to group the scores.  
   You may also set a breakdown and element to filter the scores.
   * For the widget to show scores grouped by the elements of a breakdown, select a breakdown in the Breakdown field. Do not select an element or a second breakdown.
   * You can have the widget show different elements depending on characteristics of the viewer. To do so, specify an elements filter in the Element Settings tab. Do not specify an element in the Element field. You can personalize only the first-level breakdown elements. For more information, see [Personalized visuals](https://www.servicenow.com/docs/pWW2p7IBnsMkn7rfAVfO6A#personalized-visuals "Configure visuals with dynamic elements to show information that applies only to the person looking at the visual on a dashboard, service portal, or Workspace canvas.").
   * For the widget to show scores filtered by an element of one breakdown then grouped by the elements of another breakdown, select the filtering breakdown and element in the Breakdown and Element fields. Then select the grouping breakdown in the 2nd Breakdown field. The widget shows scores for each element of the 2nd Breakdown but only if they match the first Breakdown and Element.  
     Note:  
     * Second-level breakdowns must be enabled on the indicator record, in the Collect breakdown matrix tab.
     * To have a second breakdown, Follow element must be disabled. Dashboard breakdowns count as one breakdown level of the two that are possible.
   * The widget can also show scores grouped by one breakdown and filtered by an element that the user selects on a breakdown dashboard. Select the grouping breakdown in the Breakdown field. Then select Follow element as described in a later step.

   {#create-pie-widget__choices_xld_vw5_lhb}  
   Important:  
   If the widget is for a formula indicator, all contributing indicators in the formula must support the breakdown. Otherwise an error message instead of a value appears in the widget on a dashboard.
7. To have the widget follow the breakdown elements that are selected on a breakdown dashboard, follow these steps:
   1. Select Follow element.  
      Selecting this option removes the ability to set a filtering
      breakdown on the widget. Scores are grouped by the elements of the
      first breakdown and filtered by the elements that the user selects
      on the dashboard.
      {#create-pie-widget__substep_follow-element}
   {#create-pie-widget__substep_follow-element}
   2. **Optional:** Set which of the available breakdowns to follow in Followed breakdown.  
      Breakdown dashboards let you select a breakdown source and elements. However, an indicator can use more than one breakdown that is based on the same breakdown source. Use this setting to determine which of these breakdowns to apply in a breakdown dashboard.

      For example, the
      indicator Number of open incidents uses two breakdowns: Assigned to,
      and Opened by. Both breakdowns are based on the Users.Active
      breakdown source. Consider the case where you create a widget for
      this indicator and you have the widget follow elements on breakdown
      dashboards. You want the widget to show separate values for the
      elements of the breakdown Assigned to. Therefore, you select
      Assigned to in the field
      Followed breakdown.
      {#create-pie-widget__substep_followed-breakdown}
   {#create-pie-widget__substep_followed-breakdown}
   3. In Show multiple elements as, only the Aggregated view is possible. {#create-pie-widget__substep_show-mult-elements}
   {#create-pie-widget__substep_show-mult-elements}

   {#create-pie-widget__substeps_vbp_5qn_lhb}  
   For more information, see [Configure widgets for breakdown dashboards](https://www.servicenow.com/docs/RArZvMN29Oxy4DkNa0Qdag "Configure each widget that goes on a breakdown dashboard. The configuration determines whether and how the widget follows the elements selected on the dashboard. For some widgets and indicators, you can select whether to show multiple element values separately or as an aggregate.").  
   Note:  
   The Followed breakdown relation menu works only with Scorecard visualizations. Also, multiple element selection on a breakdown dashboard is not supported on the widget when you set a breakdown relation to follow. {#create-pie-widget__cmd_follow-elements}
8. **Optional:** Fill in any of the following fields:  
   {#create-pie-widget__choicetable_kbb_mhw_1bb__entry__2}{#create-pie-widget__chrow_time-series}{#create-pie-widget__chrow_sort-on}

   | Field | Description |
   |-|-|
   | Time series | Run a function on the scores for a specific time period, such as applying a 7-day sum or average. from being applied to the indicator. For more information, see [Applying time series aggregations](https://www.servicenow.com/docs/x3ZyHNO2xeIoG5lXS685mg#applying-time-series-aggregations "You can aggregate changes in indicators into discrete time intervals. These aggregations can make trends more easily visible, or help track progress against a target."). Note: Business and fiscal calendars do not support time series aggregations. You cannot set a time series aggregation on a widget for an indicator that uses such a calendar. |
   | Sort on Sort direction | Sort the data on the Sort on attribute. Then select whether to sort in ascending or descending order. Note: The system attempts to sort the data based on the scores from the latest collection job. If the latest job did not collect any scores, the Sort on setting is ignored. |
   | Color scheme | A spectrum of colors for the scores for all breakdowns. If only one breakdown is shown, only the first color is used. If you do not specify a color scheme, the colors defined in the system property glide.ui.chart.default.colors apply. You can create your own color scheme instead of using a provided color scheme. For more information, see [Create a color scheme](https://www.servicenow.com/docs/FN_rbX~_55kZzv0NYpCoig#t_CreateAChartColorScheme "Create a reusable set of colors available for reports, Performance Analytics widgets, and Platform Analytics data visualization components."). |
   [ ]

   {#create-pie-widget__choicetable_kbb_mhw_1bb}
9. **Optional:** Review the Settings tabs and change settings as desired.  
   For more information, see [Additional settings for breakdown widgets](https://www.servicenow.com/docs/C~HTR_2iS7zSBprkANnYDA "Breakdown widgets have the following optional settings for the date range, the display, the grouping breakdown, and for the column contents. Not all options are available for all visualizations.").
10. Click Submit.

## What to do next

To view the widget, add it to a dashboard or a portal.
**Related concepts**   

* [Performance Analytics widgets on Service Portal](https://www.servicenow.com/docs/VeXWP4d~PJa~AUkiKyq3Xg#service-portal-pa-widget "You can show Performance Analytics indicators and breakdowns using Service Portal.")
* [Grouping by breakdown and filtering by breakdown](https://www.servicenow.com/docs/BWU4qHTThT6zCDXTcIi3lQ "In breakdown widgets, breakdowns either group or filter indicator scores. When you create a widget, this dual purpose of breakdowns affects the function of the breakdown fields.")
* [Interacting with breakdown widgets on dashboards](https://www.servicenow.com/docs/tS~ptu0xUlHhNUnyhc77cw "Performance Analytics users can interact with individual breakdown widgets on dashboards to change the visualization or breakdown.")  
**Related tasks**   

* [Edit a responsive dashboard](https://www.servicenow.com/docs/DOHWNLKOoFvahYSO7tT_cw "You can edit the contents of a dashboard, including Performance Analytics widgets, reports, and tabs. Because dashboards are shared, any modifications you make are applied globally.")

*[\>]: and then