---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/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 single score data visualization

# Create a single score data visualization in the Visualization Designer or on a dashboard {#ariaid-title1}

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

Use a single score to show a value as a number or percentage. Visualize how the value compares to a target or benchmark, to track progress, or to identify areas for improvement.

## 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. If 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/17aJiqgCUPOrv8FkFCAkpA "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/8TGffADoM40mPhdhdpuM8g "Platform Analytics has both unique roles and roles from other applications that apply to it.").

## About this task

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

## Procedure

1. Navigate to AllPlatform AnalyticsLibraryData Visualizations. {#create-dv-sing-sc-ac__ph_yvn_xvt_4tb}
2. Select New. {#create-dv-sing-sc-ac__ph_mdy_zvt_4tb}
3. Select the Single score (![Data visualization single score icon]()) visualization type.
4. Configure the Header and border. Header and border options are the same for all data sources.  
   {#create-dv-sing-sc-ac__table_ly5_djk_c5b__entry__2}{#create-dv-sing-sc-ac__ac-dv-showheader}{#create-dv-sing-sc-ac__ac-dv-showheadersep}{#create-dv-sing-sc-ac__ac-dv-charttitle}{#create-dv-sing-sc-ac__ac-dv-chartdesc}{#create-dv-sing-sc-ac__ac-dv-wraptitle}{#create-dv-sing-sc-ac__ac-dv-showborder}{#create-dv-sing-sc-ac__ac-dv-bare}

   | 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. |
   | Wrap title | Option to wrap long titles onto a second line. If false, displays an ellipsis to truncate long titles. |
   | 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. |
   [ ]

   {#create-dv-sing-sc-ac__table_ly5_djk_c5b} {#create-dv-sing-sc-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/diBlFzydCCBvbZFdoeAo6w "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-sing-sc-ac__table-data-source}

     Configured report sources appear in the Predefined conditions list. For more information, see [Report sources](https://www.servicenow.com/docs/QQ9qR_HtMUisYy~f~8Kt0w#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/IFlZK855mAGJVwM1MlD49w#condition-operators-ind-bkdowns__section_breakdown-operators).
   * User Experience Analytics (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 visualizations](https://www.servicenow.com/docs/hD0Xs3~bPK5Hz6vN8ZQEXQ "You can show metrics related to User Experience Analytics in a data visualization component. The available metrics depend on the visualization type.").
   {#create-dv-sing-sc-ac__choices_wvq_5vn_s2c}
6. Select the options for your data source.  
   * If your visualization represents table data, go to [Table data options for single score visualizations](https://www.servicenow.com/docs/Ila0SALkRx1qdfTk7RkTjQ "When you select a table data source for a single score visualization, the following Data configuration options are available.").
   * If your visualization represents indicator data, go to [Indicator data options for single score visualizations](https://www.servicenow.com/docs/NkX7YKX~3F4Q7WWcAf9ilg "When you select an indicator data source for a single score visualization, the following Data configuration options are available.").
   * If your visualization represents User Experience Analytics data, go to [User Experience Analytics data options for Single scores](https://www.servicenow.com/docs/C1XFTQBIzXnXxA5MiBCJAg "When you select a User Experience Analytics data source for a single score visualization, the following Data configuration options are available.").
   {#create-dv-sing-sc-ac__ul_zcw_w5s_qtb}
7. Under Presentation, provide display and color information..  
   {#create-dv-sing-sc-ac__table_jkm_pcm_t5b__entry__2}

   | Field | Description |
   |-|-|
   | Display settings ||
   | Score size | Sets the size of the score. Options include: * XS `xs` * S `sm` * M `md` * L `lg` * XL `xl` * XXL `xxl` * Auto `auto`: Size adjusts automatically between the preceding sizes depending on the viewport size and the space available after all details have been added in the Additional settings. {#create-dv-sing-sc-ac__ul_t2t_xck_grb} |
   | Score icon | Select one of the icons provided with the design system to precede the score. Optional. Note: See <https://developer.servicenow.com/dev.do#!/reference/next-experience/xanadu/now-components/now-icon/gallery> for more information. |
   | Icon style | Select "With background" to apply color to the background of the icon. Select "No background" to apply color to the icon itself. |
   | Metric label position | Position for the metric label. Options include: * Above score `top` * Below score `bottom` {#create-dv-sing-sc-ac__ul_phn_cls_2rb} This property applies only with table data sources and when Show metric label is true. |
   | Sparkline style | Style of sparkline chart. Options include: * Area `area`: Option to display the sparkline as a line with the area between its points and the horizontal axis colored in. * Line `line`: Option to display the sparkline as a line. {#create-dv-sing-sc-ac__ul_nyl_qgy_drb} This property applies only with indicator data sources and when Show sparkline is true. |
   | Colors ||
   | Set color type | * 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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US). * Single color/Colors per metric: Select a single color in the Set value color field. Interacting with that field opens a selector where you can choose the color from either a set of icons or from a list. You can also search for a color. Entering a search value has the selector show you a list of colors filtered by that search value. Alternatively, you can add a rule to define a dynamic color. For more information, see [Create coloring rules for data visualizations](https://www.servicenow.com/docs/C8RPKagr71GH0N2arYVDAA#dv-coloring-rules "Configure rules for how numerical values are displayed, to easily highlight why a value is important."). {#create-dv-sing-sc-ac__ul_nnq_mf3_dwb} |
   [ ]

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

   | Field | Description |
   |-|-|
   | Allow chart interaction | Enable an event to occur when a user clicks in a chart or one of its segments. |
   | Action | Choose the event that occurs when a user clicks in a chart 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/yGWWEWTqYeAHuGDmdBgpgw "You can set what occurs when a user interacts with a chart, 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 the records view in a Core UI list or KPI Details relevant to the associated segment or visualization. Records do not open in Workspace embedded lists. Not supported for User Experience Analytics data sources. * 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. * 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 interactions]

   {#create-dv-sing-sc-ac__table_qnp_d2d_b1c}
9. Select Save to continue editing the visualization, or Save and close to return to the Analytics Center main screen.
{#create-dv-sing-sc-ac__steps_gj3_4ry_5r}

## What to do next

* [Add a visualization to a dashboard from the Visualization Designer](https://www.servicenow.com/docs/egiLldOAJ0Rkqk3sTKQ4Lw "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/B~~wYpU7PNDElS0NvWvlxQ#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/PtIix17O5PhaUlRmVA6_7A "Bookmark a visualization so that you can find it easily in the Data Visualizations library.")
{#create-dv-sing-sc-ac__ul_bz5_byk_qtb}

*[\>]: and then