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


---

# Box plot visualization

# Create a box plot data visualization {#ariaid-title1}

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

Use a box plot to show the median and lower and upper quartiles of numeric data along with outliers. You can also compare the distribution of different groups of this data.

## Before you begin

Important:  
The box plot visualization is included in the latest data visualizations application from the ServiceNow® Store.

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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/8TGffADoM40mPhdhdpuM8g "Platform Analytics has both unique roles and roles from other applications that apply to it.").

## About this task

The Box Plot visualization only supports table data. Indicator, MetricBase, and User Experience Analytics data is not supported.

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

## Procedure

1. Navigate to AllPlatform AnalyticsLibraryData Visualizations. {#create-dv-box-plot__ph_yvn_xvt_4tb}
2. Select New. {#create-dv-box-plot__ph_mdy_zvt_4tb}
3. Select the Box Plot (![vertical box icon]()) visualization type.
4. Configure the Header and border. Header and border options are the same for all data sources.  
   {#create-dv-box-plot__table_ly5_djk_c5b__entry__2}{#create-dv-box-plot__ac-dv-showheader}{#create-dv-box-plot__ac-dv-showheadersep}{#create-dv-box-plot__ac-dv-charttitle}{#create-dv-box-plot__ac-dv-chartdesc}{#create-dv-box-plot__ac-dv-wraptitle}{#create-dv-box-plot__ac-dv-showborder}{#create-dv-box-plot__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-box-plot__table_ly5_djk_c5b} {#create-dv-box-plot__ph_m1w_vwt_4tb}
5. Open the Data Source selector and select a table.
6. Configure the data settings as described in [Table data options for box plot visualizations](https://servicenow-prod.fluidtopics.net/JqJOw9xcCrpQP2ENYWEXXg "When you select a table data source for a box plot visualization, the following Data configuration options are available.").
7. Under Presentation, provide display and color information..  
   {#create-dv-box-plot__table_jkm_pcm_t5b__entry__2}

   | Field | Description |
   |-|-|
   | Display settings ||
   | Y axis ||
   | Hide axis | Option to hide the primary axis. |
   | Primary axis title | Title to display on the vertical axis of the visualization. This property applies only when Hide primary axis is false. If there is more than one Y-axis, you have additional axis titles, representing the properties yAxis1Title, yAxis2Title, etc. Add a Y-axis scale for a metric in the More options menu for the metric. |
   | Axis range - from | Starting point for the values on the primary axis. |
   | Axis range - to | End point for the values on the primary axis. |
   | Axis position | Position of the primary axis. Options include: * Left * Right {#create-dv-box-plot__ul_gmm_jqs_2rb} This property applies only when Hide axis is false. If there is more than one primary axis, such as multiple Y axes on a vertical bar visualization, you can set each axis position separately. |
   | Show grid | Shows a grid of fine lines perpendicular to the primary axis, to help align values against that axis. |
   | Axis style | Style of the primary axis. * Clean `clean`: Adds a straight line to the primary axis. * No tick lines `noTicks`: Option to remove all marks from the primary axis. * Standard `default`: Adds a line and tick marks to the primary axis. {#create-dv-box-plot__ul_nnr_pqs_2rb} |
   | X axis ||
   | X axis title | Title to display on the horizontal axis of the visualization. |
   | 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. {#create-dv-box-plot__ul_nnq_mf3_dwb} |
   [ ]

   {#create-dv-box-plot__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-box-plot__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://servicenow-prod.fluidtopics.net/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-box-plot__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-box-plot__steps_gj3_4ry_5r}

## What to do next

* [Add a visualization to a dashboard from the Visualization Designer](https://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/PtIix17O5PhaUlRmVA6_7A "Bookmark a visualization so that you can find it easily in the Data Visualizations library.")
{#create-dv-box-plot__ul_bz5_byk_qtb}

*[\>]: and then