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

DL-01 AGRAW
Complete work holds 62% of total scope Complete 62% Remaining 28% On hold 10% Source: sample dataset v1, 2026-07-12

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

titlestring, action title stating the dominant share
eyebrowstring caps, rendered only when the DL chrome asks for it
sourcestring, rendered bottom-left, always
slicesarray 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
    }
  ]
}