Skip to main content
Pie charts show proportional data as segments of a circle. Use them when showing parts of a whole. Limit to 5-7 segments for readability.

Basic pie chart

Donut chart

A donut chart is a pie chart with a hollow center, useful for showing a total value:

With center label

Display a summary value in the center of the donut:

With legend

Always pair pie charts with a legend for accessibility:

Styling guidelines

  • Limit to 5-7 segments — more becomes unreadable
  • Use the mineral palette for category data: malachite, terracotta, cobalt, tanzanite, gold
  • Use the chart tokens (--chart-1 through --chart-5) for non-category data
  • Always include a legend — relying on color alone fails accessibility
  • Prefer donut charts over filled pie charts — the center can display summary data
  • Set paddingAngle={2} for visual separation between segments
  • Use cornerRadius={4} for rounded segment edges (modern look)