Box and whisker charts display the distribution of a set of values along an axis. They are also commonly known as box plots.

Summary of Content

Anatomy of a Box and Whisker Chart
Plot a Box and Whisker Chart
    Display Orientation
Format Options
    Customize Point Display Options
Related Resources


  • Users with edit permission on the workbook can add and edit visualizations.
  • Users with explore permission on the workbook can edit visualizations. However, their changes cannot be saved to the existing workbook.

Anatomy of a Box and Whisker Chart

Box and whisker charts break data into quartiles. The upper quartile, median, and lower quartile make up what we refer to as box. The entire spread from whisker minimum to whisker maximum, including the box, accounts for the statistically central range of data. This is called the interquartile range (IQR). Data points that fall out of the IQR are called outliers. 

Maximum: The data range's smallest value.

Upper Quartile: Values contained in the upper 25% of data.

Median: The data range's midpoint.

Lower Quartile: Values contained in the lower 25% of data.

Outliers: Values that fall above or below the IQR. 



Plot a Box and Whisker Chart

Visualizations can be created via the PAGE ELEMENTS section of your workbook's editor panel or directly from an existing data element

Visualized data will not display on the page canvas until all required plot fields are defined.

Add columns to open fields using either the field's + menu or dragging and dropping the column.


  • X-AXIS (1 column)
    Categorical data is first grouped by the column on the X-AXIS. 
  • Y-AXIS (1+ columns)
    Columns added to the visualization’s Y-AXIS are aggregated by default. Aggregation type (e.g. Sum vs Count) is dependent on the original column’s value type.
  • SPLIT BY (1 column)
    Creates a second grouping under the first grouping (defined on the X-AXIS).

Example: In the screenshot below, the X-AXIS is set to [Store State], grouping the rows of data into states. The column on the Y-AXIS, [Store Sales] defines the numerical range of the plotted data. The column added to SPLIT BY, [Store Name], acts as a grouping below [Store State]. In other words, data is grouped by state and then each state's data is grouped by (aka "split by") individual stores' names. Points on the y-axis represent the aggregate [Store Sales] values listed under the second, "split by", grouping. 



  • TOOLTIP (1+ columns)

Display Orientation (Horizontal vs Vertical)

Box and whisker charts can be displayed both vertically and horizontally. 

To select your chart’s orientation, select either the display vertical ( viz-box-vertical.svg ) or display horizontal ( viz-box-horizontal.svg ) icon button in the chart’s editor panel view.


Format Options

To begin editing a visualization's format options, select the visualization to open its editor panel view. Then click the paintbrush ( paint-brush.svg ) icon in the workbook sidebar, located on the left side of the workbook.


The following Format options are available for box and whisker charts:

Customize Point Display Options

  1. Select the visualization
  2. Click the paintbrush ( paint-brush.svg ) icon, located in the workbook sidebar.
    This will open the element’s format panel.
  3. Click BOX SHAPE.
  4. Select BOX SHAPE formatting from the options presented:
    • The Show points checkbox is checked by default. Uncheck to hide all points.
    • If Show points is selected, you can choose:
      • Outliers only – Shows only the points that fall outside the box.
      • All points – Shows all points, regardless of position.


Related Resources

Intro to Building Visualizations