The donut chart (and its solid variant, the pie chart) renders proportional data as coloured segments. Use it to show the composition of a total — budget allocation by discipline, risk count by category, resource hours by trade, or headcount by role.
When to use
- Cost allocation by budget category (design, procurement, construction, management).
- Risk count by severity or category.
- Resource hours by trade or discipline.
- Document status breakdown (submitted, approved, under review, rejected).
- Workforce composition by role, grade, or location.
Avoid donut charts for time-series data or when comparing values across periods — use a bar chart or line chart instead.
Adding the component
- Open the report output in the Output Designer.
- Click + Insert → Donut Chart.
- Position and resize the component.
- In the Data tab, bind the section and configure segments.
Data source options
| Source type | Description |
|---|
| Repeating-row section | Each row becomes a segment. The label field provides the segment name; the value field provides the segment size. |
| Aggregated field | Count, sum, or average of a field, grouped by a select or multi-select field. |
| Static values | Enter segment values manually for fixed reference charts. |
Segment configuration
| Property | Description |
|---|
| Label field | The field that provides each segment's name (shown in legend and tooltip). |
| Value field | The numeric, currency, or percent field for segment size. |
| Colour palette | Built-in palette (Categorical, Report theme, Sequential) or custom colours per segment. |
| Colour by field | Assign colours by a specific field value (e.g. RAG field → red/amber/green segments). |
| Min segment % | Segments below this threshold are merged into an "Other" segment. |
| Sort | By value (descending), by label (alphabetical), or manual order. |
| Max segments | Show top N segments; remaining are grouped as "Other". |
Chart style
| Property | Options |
|---|
| Style | Donut (hollow centre) or Pie (filled centre). |
| Hole size | Donut only — 30%–70% inner hole diameter. |
| Segment gap | Gap in pixels between segments (default: 2px). |
| Explode on hover | Viewer only — selected segment expands on hover. |
| Start angle | Rotation of the first segment (default: 90° — top). |
Centre value (donut only)
When using donut style, optionally display a value in the centre hole:
| Property | Description |
|---|
| Centre text | Static text, or a field value (e.g. total count, sum, or a KPI label). |
| Centre value field | The field or aggregation to show as the main centre number. |
| Centre sub-label | Secondary text below the centre value (e.g. "Total risks" or the period label). |
| Centre font size | 14–40pt. |
Legend
| Property | Options |
|---|
| Position | Right, Bottom, Left, or Hidden. |
| Show values | Show the numeric value beside each legend item. |
| Show percentages | Show the percentage share beside each legend item. |
| Max items | Limit legend rows shown. |
Labels
| Property | Options |
|---|
| Label position | On segment, Outside (callout), or None. |
| Label content | Segment name, value, percentage, or a combination. |
| Label threshold | Hide labels on segments smaller than N% to avoid overlap. |
Export behaviour
- PDF / Word: Full vector chart with colours and legend preserved.
- Excel: Chart embedded as a static image; segment data exported as a table on a separate sheet.
- For small chart sizes (< 150px), disable segment labels to avoid overlap.