BTA Charts
ChartsComposition

Donut Chart

Display part-to-whole relationships as proportional slices around a central hole. Supports rounded corners, inside/outside labels, center KPI display, and small multiples. A modern alternative to pie charts with better visual hierarchy.

Examples

When to Use

  • Showing how a total breaks down into component parts
  • Budget allocation or revenue share by category
  • Market share distribution across competitors
  • Any part-to-whole comparison with 3-7 categories

Data Roles

Loading data roles...

Settings

Donut Chart

Inner Radius

number

Ratio of the inner hole to the outer radius (0.2-0.85).

Default: 0.67

Slice Padding

number

Gap between slices in radians.

Default: 0.02

Rounded Corners

boolean

Apply rounded corners to slice edges.

Default: true

Corner Radius

number

Radius of rounded corners in pixels.

Default: 6

Show Center

boolean

Display a label and value in the center hole.

Default: true

Center Label

string

Text shown above the center value.

Default: Total

Center Value

dropdown

What to display in the center: total or none.

Default: total

Hover Highlight

boolean

Enlarge the hovered slice for emphasis.

Default: true

Data Labels

Show Labels

boolean

Display labels on or near slices.

Default: true

Label Content

dropdown

What to show: category, value, percent, or combinations.

Default: categoryPercent

Label Position

dropdown

Place labels inside slices or outside with leader lines.

Default: inside

Auto Fit

boolean

Automatically shrink or hide labels that overflow.

Default: true

Overflow To Outside

boolean

Move labels outside when they do not fit inside the slice.

Default: true

Color & Appearance

Color Scheme

dropdown

Controls the color palette for slices.

Default: rainbow

Common settings like Legend, Tooltip, and Small Multiples configuration are covered in Shared Concepts.

Tips & Best Practices

  • Keep slices under 7 for readability -- combine small categories into "Other"
  • Use the center label to display a meaningful total or KPI
  • Enable "Overflow To Outside" for small slices that cannot fit labels inside

On this page