# Angular Box Plot Charts

Box Plot charts are categorical charts that graphically render groups of numerical data through their [quartiles](https://en.wikipedia.org/wiki/Quartile). Also known as box and whiskers charts, they display a data distribution summary with six statistical indicators—lower value, first quartile, median, mean, third quartile, and upper value—plus outliers for each series.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/box-plot/overview/source.txt)

## Binding to Data

You can bind the Box Plot chart series to an array through the [`data`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#data) property in two formats:

* Binding to arrays—Use arrays of `[lower, q1, median, q3, upper]` values where each element represents the statistical distribution values.

  ```ts
      public data: [number, number, number, number, number][] = [
          [10, 15, 20, 25, 30],
          [12, 18, 22, 28, 32],
          [8, 13, 19, 23, 27]
      ];
  ```

* Binding to objects—Use an array of objects with custom properties.

  ```ts
  public data: Array<{
      category: string;
      lower: number;
      q1: number;
      median: number;
      q3: number;
      upper: number;
      mean?: number;
      outliers?: number[];
  }> = [
      {
          category: 'Q1',
          lower: 10,
          q1: 15,
          median: 20,
          q3: 25,
          upper: 30,
          mean: 20.5,
          outliers: [5, 35]
      },
      {
          category: 'Q2',
          lower: 12,
          q1: 18,
          median: 22,
          q3: 28,
          upper: 32
      }
  ];
  ```

  When binding to objects, specify which properties contain the data through the following field mappings:

  | Property                                                                                                            | Data type | Required | Description                                                                                                         |
  | ------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
  | [`lowerField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#lowerfield)       | `string`  | Yes\*    | The property name that contains the lower value with `number` values (\*required when binding to objects).          |
  | [`categoryField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#categoryfield) | `string`  | No       | The property name that contains the category with `string`, `date`, or `number` values.                             |
  | [`q1Field`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#q1field)             | `string`  | Yes\*    | The property name that contains the first quartile value with `number` values (\*required when binding to objects). |
  | [`medianField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#medianfield)     | `string`  | Yes\*    | The property name that contains the median value with `number` values (\*required when binding to objects).         |
  | [`q3Field`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#q3field)             | `string`  | Yes\*    | The property name that contains the third quartile value with `number` values (\*required when binding to objects). |
  | [`upperField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#upperfield)       | `string`  | Yes\*    | The property name that contains the upper value with `number` values (\*required when binding to objects).          |
  | [`meanField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#meanfield)         | `string`  | No       | The property name that contains the mean value with `number` values.                                                |
  | [`outliersField`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#outliersfield) | `string`  | No       | The property name that contains the outliers array with `number[]` values.                                          |

The following example demonstrates how to bind the Box Plot chart series to data using object models.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/box-plot/data-binding/source.txt)

## Vertical Box Plot

The Box Plot chart type also supports a vertical orientation by setting the series [`type`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#type) to `verticalBoxPlot`. When you use `verticalBoxPlot`, the chart rotates the box plots 90 degrees, displaying categories along the vertical axis and values along the horizontal axis. This orientation can be useful when you have long category names or when you want to emphasize the horizontal distribution of values.

The vertical box plot accepts the same data structure and field mappings as the standard box plot. All customization options for [`mean`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#mean), [`median`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#median), [`outliers`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#outliers), and [`whiskers`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#whiskers) are also available.

The following example demonstrates how to create a vertical Box Plot chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/box-plot/vertical/source.txt)

## Customizing the Appearance

The Box Plot chart provides configuration options for customizing the visual appearance of its statistical elements:

* [`color`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#color) and [`border`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#border)—Control the box fill color and border styling (color, width, dashType).
* [`mean`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#mean)—Customize the mean line appearance, which is dashed by default (color, width, dashType).
* [`median`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#median)—Configure the median line that divides the box (color, width, dashType).
* [`whiskers`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#whiskers)—Style the lines extending to minimum and maximum values (color, width, dashType).
* [`outliers`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesitemcomponent#outliers)—Customize the markers for data points outside the whisker range (background, border, size, type).

The following example demonstrates how to customize the appearance of the elements of the Box Plot chart.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/box-plot/box-plot-custom/source.txt)

## Support and Learning Resources

* [Box Plot Chart Homepage](https://www.telerik.com/kendo-angular-ui/charts#box-plot-chart)
* [Getting Started with the Kendo UI for Angular Chart](https://www.telerik.com/kendo-angular-ui/components/charts/installation/getting-started)
* [API Reference of the Charts](https://www.telerik.com/kendo-angular-ui/components/charts/api)
* [Area Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/area)
* [Bar Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/bar)
* [Bullet Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/bullet)
* [Line Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/line)
* [Radar Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/radar)
* [RangeArea Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/range-area)
* [RangeBar Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/range-bar)
* [Waterfall Charts](https://www.telerik.com/kendo-angular-ui/components/charts/series-types/waterfall)
* [Getting Started with Kendo UI for Angular (Online Guide)](https://www.telerik.com/kendo-angular-ui/components/getting-started)
* [Getting Started with Kendo UI for Angular (Video Tutorial)](https://www.telerik.com/campaigns/kendo-ui/using-kendo-ui-with-angular-video-tutorial)
* [Video Courses](https://www.telerik.com/kendo-angular-ui/components/getting-started/video-onboarding)
* [Chart Forum](https://www.telerik.com/forums/kendo-angular-ui?tagId=256)
* [Before You Start: All Things Angular (Telerik Blog Post)](https://www.telerik.com/blogs/all-things-angular)
* [Knowledge Base](https://www.telerik.com/kendo-angular-ui/components/knowledge-base)

## Additional Resources

* [Angular Blogs](https://www.telerik.com/blogs/tag/kendo-ui-for-angular)
* [Angular Videos](https://www.telerik.com/videos/kendo-angular-ui)
* [Kendo UI for Angular Roadmap](https://www.telerik.com/support/whats-new/kendo-angular-ui/roadmap)
