# Donut

Donut charts are circular charts which represent a variation of the [Pie charts](https://www.telerik.com/kendo-react-ui/components/charts/series-types/pie) and are capable of displaying multiple nested series.

You can utilize the blank center of a Donut chart to show additional information within it.

<CtaPanelOverview></CtaPanelOverview>

## Basic Usage

The following example demonstrates the Donut chart in action.

[Demo Source](https://demos.telerik.com/kendo-react-ui/charts/chart/donut/func/source.txt)

## Displaying Multiple Series

The Donut chart renders multiple series in the form of concentric rings. This behavior is different from the behavior of the Pie chart, which supports only one series.

The following example demonstrates how to render multiple data series as concentric rings in a Donut chart.

[Demo Source](https://demos.telerik.com/kendo-react-ui/charts/chart/donut-series/func/source.txt)

## Customizing the Appearance

You can customize the visual appearance of the Donut chart through several properties that control the chart's structure and styling:

* [`holeSize`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#holesize)—Specifies the diameter of the center hole in pixels. Larger values create a thinner ring.
* [`startAngle`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#startangle)—Determines the starting angle in degrees for the first segment.
* [`padding`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#padding)—Sets the spacing around the chart in pixels.
* [`border`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#border)—Configures the border appearance for the Donut series with color, opacity, and width properties.
* [`colorField`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#colorfield)—Specifies the data field that provides a color for each category.
* [`opacity`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#opacity)—Controls the transparency of the segments.
* [`overlay`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#overlay)—Specifies the appearance effect for the series. Use `roundedBevel` or `sharpBevel` for a beveled effect, or `none` for a flat appearance.

The following example demonstrates the Donut appearance settings in one chart:

[Demo Source](https://demos.telerik.com/kendo-react-ui/charts/chart/donut-appearance/func/source.txt)

## Displaying Information in the Center

To display content in the center of the Donut chart, either:

* [Utilize the Donut center template](https://www.telerik.com/kendo-react-ui/components/charts/series-types/donut#using-the-center-template), or
* [Implement drawing visuals](https://www.telerik.com/kendo-react-ui/components/charts/series-types/donut#using-drawing-visuals).

### Using the Center Template

The center template is an HTML overlay that is positioned over the center of the Donut chart. To implement the content use the [donutCenterRender](https://www.telerik.com/kendo-react-ui/components/charts/api/chartprops#donutcenterrender) render prop of the `Chart` component.

> While documents which are exported through the [HTML Drawing API](https://www.telerik.com/kendo-react-ui/components/drawing/draw-dom) display the content of the center template, vector graphics and [exported files](https://www.telerik.com/kendo-react-ui/components/charts/chart/export-options) do not render it.

The following example demonstrates how to use the [`donutCenterRender`](https://www.telerik.com/kendo-react-ui/components/charts/api/chartprops#donutcenterrender) prop to display a dynamic HTML overlay in the center of the Donut chart.

[Demo Source](https://demos.telerik.com/kendo-react-ui/charts/chart/donut-center/func/source.txt)

### Using Drawing Visuals

Similar to the other Chart types, you can overlay the Donut series with custom [drawing elements](https://www.telerik.com/kendo-react-ui/components/drawing). The approach of using drawing visuals is more flexible than using the donut center template and also has the advantage that the overlay is part of the chart drawing surface. As a result, all [exported files](https://www.telerik.com/kendo-react-ui/components/charts/chart/export-options) render the content of the donut center as an integral element of the component.

[Demo Source](https://demos.telerik.com/kendo-react-ui/charts/chart/donut-center-visuals/func/source.txt)

## Suggested Links

* [API Reference of the Charts](https://www.telerik.com/kendo-react-ui/components/charts/api)
* [Pie Charts](https://www.telerik.com/kendo-react-ui/components/charts/series-types/pie)
