Radial Chart

Charts

A single-metric progress gauge.

Radial charts display one metric against a target as an arc that fills around a circle. They are a compact, glanceable way to show progress, scores, or capacity.

npx shadcn@latest add radial-chart

Default

A score of 72 out of 100.

Preview
Live
72Health score
tsx
1<RadialChart value={72} label="Health score" height={220} />

Custom

A different color, target, and label.

Preview
Live
1860Monthly goal
tsx
1<RadialChart
2 value={1860}
3 max={2400}
4 label="Monthly goal"
5 color="var(--color-chart-3)"
6 height={220}
7/>

API reference

All props of the underlying Base UI primitive are forwarded. The table below documents the Shelf-specific props.

PropTypeDescription
valuenumberThe current value of the metric.
maxnumber= 100The target value the arc fills toward.
colorstring= "var(--color-primary)"The fill color of the arc.
labelstringOptional text rendered under the centered value.
heightnumber= 220The chart height in pixels.