Pie Chart Preset
Doughnut
Doughnut is an OPF pie chart preset with canonical workbook metadata, sample data, and engine chart type mapping.
Use Case
Show share of total across a limited set of categories.
Data Requirements
1 series, 2 categories, flat category/series workbook
Group
Part-to-whole charts for a small number of segments.
Series
1 series across 2 categories
Workbook Range
Sheet1!$A$1:$C$2
When to Use
Use when the audience needs a quick composition read with two to five meaningful segments.
When to Avoid
Avoid when precise comparison between similar slices is required.
Series colors
By default a chart takes its series colors from the deck's color scheme. Series 1 to 6 use accent1 to accent6 of the scheme in that order; series 7 to 12 use the same six accents mixed 40% toward white (series 7 is a tint of accent1). A pie, doughnut, treemap or funnel gives category i color i. Charts with more than twelve series repeat the list.
Put the series that carries the message first, because accent1 is the deck's primary, and keep a chart to six series or fewer so no tint is needed. Each color is then adjusted so it keeps 3:1 contrast against the chart panel and stays apart from its neighbours; on a dark panel colors are lightened, never merged.
To set a series color yourself, give the chart chart.colors: a list of up to 24 colors by position, where entry i replaces the palette color of series (or slice, for a pie) i and the rest of the palette is unchanged. An entry is any ColorRef: a hex color, a color-scheme slot or role such as accent3 (it follows the deck if its scheme changes), or a var: color variable. The contrast adjustment still applies to authored colors, and the opf/chart-colors-adjusted warning says when an entry was unresolvable or had to be moved.
"chart": {
"type": "column",
"data": { "columns": ["Quarter", "Revenue", "Costs"], "rows": [["Q1", 12, 8], ["Q2", 18, 11]] },
"colors": ["accent3", "#7B241C"]
}highlight wins over both: the series and categories it names take the deck's primary color and every other mark takes a muted neutral, whatever chart.colors says.
Core 0.21.0 behavior.
Best Practices
Limit segment count
Label slices directly
Order slices by size or narrative priority
Recommended Companions
OPF Config
charts:doughnut{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "PPTX.gallery — charts/doughnut",
"description": "Doughnut is an OPF pie chart preset with canonical workbook metadata, sample data, and engine chart type mapping.",
"tags": [
"gallery:charts/doughnut"
],
"slides": [
{
"id": "gallery-preview-1",
"layout": "chart",
"title": "Doughnut",
"subtitle": "Show share of total across a limited set of categories.",
"chart": {
"type": "doughnut",
"data": {
"columns": [
"Segment",
"Value 1"
],
"rows": [
[
"Q1 2024",
63264
],
[
"Q2 2024",
91351
]
]
}
}
}
],
"catalogs": {
"default": {
"source": "https://www.pptx.gallery",
"layouts": {
"chart": {
"name": "Chart",
"summary": "One to six charts, with an optional note.",
"tags": [
"Visuals"
],
"direction": "column",
"regions": [
{
"name": "title"
},
{
"name": "charts",
"accepts": [
"chart",
"group"
],
"role": "primary",
"flow": "grid"
},
{
"name": "note",
"size": "auto",
"accepts": [
"text"
],
"role": "supporting",
"flow": "none"
}
],
"description": "Give a chart enough space to show its evidence. Use the title to state the conclusion and labels to explain the measures.",
"preview": {
"vectorSrc": "https://www.pptx.gallery/layout-previews/chart.svg"
}
}
}
}
}
}Load this config in the gallery's visual editor, or in the Inspector at pptx.dev.