---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create a scorecard visualization in a list widget

# Create a scorecard visualization in a list widget {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read

To list the metrics of several indicators, use a scorecard visualization in a list
widget.

## 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://servicenow-prod.fluidtopics.net/cTK92MA3IiY1_3pv041ktA "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.") or [Filters in Platform Analytics](https://servicenow-prod.fluidtopics.net/dLtrHm3CmdIO7YIX95Vpbg "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.  
Use this visualization to help compare several similar indicators regarding their scores, the trend in their scores, and their compliance with targets.Figure 1. Scorecard visualization - list widget

## Procedure

1. Navigate to AllPerformance AnalyticsWidgets. {#create-scorecard-list-widget__step_nav-to-widgets}
{#create-scorecard-list-widget__step_nav-to-widgets}
2. Click New. {#create-scorecard-list-widget__step_click-new}
{#create-scorecard-list-widget__step_click-new}
3. In the Name field, give the widget a name that reflects the information being displayed. {#create-scorecard-list-widget__step_name-widget}
{#create-scorecard-list-widget__step_name-widget}
4. In the Type field, select List.  
   If you change the value of Type after you fill in other fields, those fields are cleared. {#create-scorecard-list-widget__step_select-time-series}
{#create-scorecard-list-widget__step_select-time-series}
5. In the Visualization field, select Scorecard. {#create-scorecard-list-widget__step_select-visualization}
{#create-scorecard-list-widget__step_select-visualization}
6. Select indicators in one of the following ways:
   * Select a group in the Indicator Group field.
   * Click Save, then add widget indicators as described in [Add widget indicators](https://servicenow-prod.fluidtopics.net/uvFzMTyLTQWXsxA0A6C_jw "Add any number of secondary indicators to an existing time series or list widget.").
   {#create-scorecard-list-widget__choices_rh3_sgr_w1b}
7. To aggregate the widget data for a specific time period, such as applying a 7-day sum or average, select a function in the Time series field.  
   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.
8. To have the widget follow the breakdown elements that are selected on a breakdown dashboard, follow these steps:
   1. Select 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 display separate values for the
      elements of the Assigned to breakdown. Therefore, you select
      Assigned to in the field
      Followed breakdown.
   3. In Show multiple elements as, select whether to show each element separately or to show an aggregate of elements based on the indicator aggregation.  
      Neither all widget visualizations nor all indicators support both aggregate and separate views. For automated and external indicators, only COUNT, SUM, MAX, and MIN data aggregations support aggregate views. COUNT DISTINCT and AVG do not. For more information, see [Showing multiple elements separately or aggregated](https://servicenow-prod.fluidtopics.net/p7K28vzH4ZGDFu_j7azE0w "When you select multiple elements on a dashboard, widgets that follow these elements can show their values either separately or as an aggregate.").
   {#create-scorecard-list-widget__substeps_vbp_5qn_lhb}
9. **Optional:** Select the attribute on which to sort the data in the Sort on field.
10. Select the scores and metrics to show in the Column Settings tab.  
    {#create-scorecard-list-widget__table_ztf_53r_w1b__entry__2}

    | Column setting | Description |
    |-|-|
    | Current score | Show the score from the latest data collection. Selected by default. |
    | Trend | Shows the direction that the indicator is moving. The trend is shown in a mini-chart on the dashboard. Selected by default. |
    | Bullet chart | Show a graphic that shows how close the latest score is to the latest target score. The graphic only appears if the indicator has a defined target. |
    | Multiple scores | Shows the number of scores that are defined in the Number of periods field, which appears when Multiple scores is selected. If Current Score is also selected, the most recent period is labeled Score. Otherwise, the most recent period is labeled with the date. |
    | Number of periods | Select the number of additional periods to include in the widget. |
    | Period step | If the Number of periods \> 1, select the length of each period. The unit is based on the frequency of the first indicator. Note: Including indicators with different frequencies, such as daily or weekly, may result in different numbers of periods per indicator. For example, if the first indicator has a daily frequency, and another indicator has a weekly frequency, the daily indicator shows 7 scores for every 1 score of the weekly indicator. |
    | Change | Shows the change in value from the previous score. |
    | Change % | Shows the percentage change from the previous score. |
    | Target | Shows the target for the indicator. A value appears only if the indicator has a defined target. The target and current score are shown graphically in the Bullet chart. |
    | Gap | Shows the difference between the current score and the target. For indicators with a Maximize direction, the gap calculation is Score--Target. For indicators with a Minimize direction, the calculation is Target--Score. Thus a positive value is always good, and a negative value is always bad. A value appears only if the indicator has a defined target. |
    | Gap % | Shows the percentage difference between the current and target scores. As with Gap, a positive Gap % is always good, and a negative Gap % is always bad, regardless of the direction of the indicator. A value appears only if the indicator has a defined target. |
    [ ]

    {#create-scorecard-list-widget__table_ztf_53r_w1b}
11. **Optional:** Filter which indicators to show in the List Settings tab.  
    {#create-scorecard-list-widget__table_gmc_yhr_w1b__entry__2}

    | List setting | Description |
    |-|-|
    | Scorecard options | Select All indicators, indicators marked Key, or Favorite indicators to show only those indicators on the dashboard. |
    | Page size | Select the number of rows to show on the list scorecard. |
    | Filter | Filter the scorecard list for Best Performing, Worst Performing, Improved, Declined, or Deteriorated. Only indicator scores that match the filter are shown. |
    [ ]

    {#create-scorecard-list-widget__table_gmc_yhr_w1b}
12. Click Submit or Update.

## What to do next

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

*[\>]: and then