---
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 real-time score visualization for a score widget

# Create a real-time score visualization for a score widget {#ariaid-title1}

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

To see the current score, use a real-time score visualization in a score widget. You
can also show a trend line of scores.

## Before you begin

* The indicator for which you want the real-time scores must have the Show real-time score property enabled.
* Role required: pa_power_user or admin
{#create-real-time-score-widget__ul_rhz_rtf_x1b}

## 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.

A real-time score visualization shows the current score
and both the absolute and percentage change between this score and the score at the last
previous scheduled data collection. The score is calculated when a dashboard user opens
a dashboard that contains the widget. This visualization is similar to a
Chart view in an Analytics Hub. You can also
show a trend line of absolute or percentage changes in scores.

For more information,
see [Real-time scores](https://servicenow-prod.fluidtopics.net/u~jPyrceyxEPquqQ2AJoKw "You can view some Performance Analytics scores in real-time instead of from the most recent data collection job. If real-time scores are enabled, you can view them on the Analytics Hub and in some widgets and reports.").  
Warning:  
* Real-time scores can differ per viewer and differ from collected scores. Real-time scores are taken directly from the relevant facts tables. Therefore, the Access Control Lists (ACL) of those facts tables determine the real-time scores that each logged-in user sees.
* If the widget has too many data elements, it cannot update in real time. In this case, a message appears that instructs the viewer to refresh the widget manually.
{#create-real-time-score-widget__ul_opy_lmj_nsb}
Figure 1. Real-time score visualization

## Procedure

1. Navigate to AllPerformance AnalyticsWidgets. {#create-real-time-score-widget__step_nav-to-widgets}
{#create-real-time-score-widget__step_nav-to-widgets}
2. Click New. {#create-real-time-score-widget__step_click-new}
{#create-real-time-score-widget__step_click-new}
3. In the Name and Subtitle fields, give the widget a name and subtitle that reflect the information being displayed. {#create-real-time-score-widget__step_name-widget}
{#create-real-time-score-widget__step_name-widget}
4. In the Type field, select Score.  
   If you change the value of Type after you fill in other fields, those fields are cleared. {#create-real-time-score-widget__step_select-time-series}
{#create-real-time-score-widget__step_select-time-series}
5. In the Visualization field, select Real-time score. {#create-real-time-score-widget__step_select-visualization}
{#create-real-time-score-widget__step_select-visualization}
6. In the Indicator field, select the indicator for which you want to show scores. {#create-real-time-score-widget__step_select-indicator}
{#create-real-time-score-widget__step_select-indicator}
7. **Optional:** Fill in any of the following fields:  
   {#create-real-time-score-widget__table_k4q_fhr_w2b__entry__2}{#create-real-time-score-widget__ph_breakdown-and-element}

   | Field | Description |
   |-|-|
   | Breakdown and Element | Only the scores that match the specified element of this breakdown are shown. Select values for both Breakdown and Element. Otherwise, only scores that are not associated with any element of the breakdown are shown. Note: Instead of specifying an element for the first-level breakdown, you can specify an elements filter in the Elements Settings tab. Use elements filters for creating personal visualizations. For more information, see [Additional settings for time series widgets](https://servicenow-prod.fluidtopics.net/FlQ25tkM_K3HpJCanX5kKw#optional-settings-ts-widgets "Time series widgets have the following optional settings for display, for the date range, and for the axis labels. You can also use these setting to select an elements filter in place of a first-level breakdown element."). 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. |
   | 2nd Breakdown and Element | Drill down to a second level of breakdown and element, if a first-level breakdown and element have been specified. Note: * Second-level breakdowns must be enabled on the indicator record, in the Collect breakdown matrix tab. * Follow element must be disabled. Dashboard breakdowns count as one breakdown level of the two that are possible. {#create-real-time-score-widget__ul_knw_l4g_1sb} |
   [ ]

   {#create-real-time-score-widget__table_k4q_fhr_w2b} {#create-real-time-score-widget__step_first-breakdown}
{#create-real-time-score-widget__step_first-breakdown}
8. 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 second breakdown and element on the widget.
   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.

   {#create-real-time-score-widget__substeps_vbp_5qn_lhb}  
   Note:  
   * If multiple elements are selected on the breakdown dashboard, only the aggregate value of the elements can be shown.
   * Record watcher is not supported on Score widgets when multiple elements are selected on a breakdown dashboard. In this case, real time is refreshed only on page refresh.
   {#create-real-time-score-widget__ul_g4x_xnx_t2c}
   For more information, see [Configure widgets for breakdown dashboards](https://servicenow-prod.fluidtopics.net/288O~J_EmIfcuvnirSmKyw "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.").
9. **Optional:** Select a template.

   | Template name | Description |
   | Template 1 | Line shows absolute change in score. |
   | Template 2 | Line shows percentage change in score. |
   | Template 3 | Line is not displayed. |
   |-|-|

   {#create-real-time-score-widget__choicetable_t55_bfq_w1b}  
   Real-time score visualizations use Template 2 by default.
10. In the Element Settings tab, you can select an element filter instead of selecting a specific element in the Element field.  
    Use this approach to personalize which breakdowns are shown depending on the viewer. For more information about using element filters to personalize widgets, see [Personalized visuals](https://servicenow-prod.fluidtopics.net/CvO_uJsbdnRF8WdRjjTtNw#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.").
11. Click Submit.

## What to do next

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

* [Real-time scores](https://servicenow-prod.fluidtopics.net/u~jPyrceyxEPquqQ2AJoKw "You can view some Performance Analytics scores in real-time instead of from the most recent data collection job. If real-time scores are enabled, you can view them on the Analytics Hub and in some widgets and reports.")
* [Performance Analytics widgets on Service Portal](https://servicenow-prod.fluidtopics.net/InqgxaNjTNqQ5CAxAVb1aQ#service-portal-pa-widget "You can show Performance Analytics indicators and breakdowns using Service Portal.")  
**Related tasks**   

* [Edit a responsive dashboard](https://servicenow-prod.fluidtopics.net/KsSuVvwEExxpMlJLyunvdQ "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.")
* [Create an automated indicator](https://servicenow-prod.fluidtopics.net/F1ajYqIPRtS9gMNTzcX0qA#t_CreateAnAutomatedIndicator "To analyze the performance of a business process that is recorded in a ServiceNow table, use an automated indicator. If a suitable indicator is not provided in a Platform Analytics Solution, create a new one.")

*[\>]: and then