Charts /
CH-PTW-04
CH-PTW-04 . family PTW
DONUT
donut, 3 slices maximum. Needs: 2 or 3 additive slices of one real total.
part-to-wholeshare
Use when
- exactly the pie use case, when the surrounding design system already standardizes on donuts
- 3 slices maximum, one clearly dominant
Do not use when
- more than 3 categories, always
- when angle reading matters (the hole removes the angle cue pies rely on)
- dashboards stacking many small donuts (use CH-TAB-01 or CH-PTW-02)
See instead
Alternatives
- CH-PTW-03 (pie)
- CH-PTW-01 (stacked bar)
Rules
- every CH-PTW-03 rule applies unchanged
- the ring must stay thick (inner radius <= 62% of outer); thin rings are unreadable
- the hole stays empty; a number in the hole belongs in the title
Never do this
- more than 3 slices (the classic dashboard donut crime)
- KPI number stuffed in the hole while the ring shows something else
- thin progress rings pretending to be charts
- legends
QA before delivering
- slices <= 3
- inner radius <= 62% of outer
- hole empty
- title states the dominant share with a number
- source line present bottom-left
Data shape
| title | string, action title stating the dominant share |
| eyebrow | string caps, rendered only when the DL chrome asks for it |
| source | string, rendered bottom-left, always |
| slices | array of {label, value > 0}, 3 maximum |
Sample data (golden)
{
"title": "Complete work holds 62% of total scope",
"eyebrow": "SCOPE . WEEK 28",
"source": "Source: sample dataset v1, 2026-07-12",
"slices": [
{
"label": "Complete",
"value": 62
},
{
"label": "Remaining",
"value": 28
},
{
"label": "On hold",
"value": 10
}
]
}