Skip to content

docs: correct the donut shape control and document the center total #11520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
igorlukanin wants to merge 3 commits into
base: master
Choose a base branch
from
+9 −5
Open

docs: correct the donut shape control and document the center total #11520

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c1845b7
docs: correct the donut shape control and document the center total
igorlukanin Aug 11, 2026
9d39c7d
docs: trim the center total section per review
igorlukanin Aug 11, 2026
2ccaea7
docs: reflect the donut centre total's default-on toggle, shared labe…
igorlukanin Aug 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions docs-mintlify/docs/explore-analyze/charts/chart-types/pie.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,15 +15,19 @@ Standard filled circle. Each slice's arc length is proportional to its value.

### Donut

A pie with a hollow center. Increase the **Inner radius** value in the Style tab to any non-zero value to switch to a donut. The hollow center can be used to surface a summary value via a [KPI](/docs/explore-analyze/charts/chart-types/kpi) tile on a dashboard, or simply to reduce visual density.
A pie with a hollow center. Select **Donut** under **Shape** in the Style tab to switch; select **Pie** to switch back.

{/* Screenshot: donut chart — same data as the pie variant, with inner radius applied. Place directly below this heading, half-width centered or side-by-side with pie. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
{/* Screenshot: donut chart — same data as the pie variant. Place directly below this heading, half-width centered or side-by-side with pie. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}

## Inner radius
## Center total

Drag the **Inner radius** slider in the Style tab or enter a pixel value. Setting it to `0` returns to a full pie.
A donut shows the measure's grand total in its hole by default, using the measure's number format. Use the **Show total** button in the Data labels section of the Style tab to turn it off or on again.

@claude claude Bot Aug 19, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two consistency nits on this sentence, both about matching what the rest of the charts docs already say:

  1. Tab placement. This puts the Data labels section in the Style tab, but configuration/data-labels.mdx:12 says "Open the Fields tab and enable the Data Labels toggle", and chart-types/bar.mdx:66 says the same. If pie genuinely differs, fine — but if the section moved to Style, those two pages are now stale and a reader who follows either will look in the wrong tab. Worth confirming which is right.

  2. "button" vs "toggle". The PR description and commit message both call this a toggle (default-on, turn off and on again), and the sibling pages consistently say toggle for this kind of control. "Button" reads like a one-shot action.

Suggested change
A donut shows the measure's grand total in its hole by default, using the measure's number format. Use the **Show total** button in the Data labels section of the Style tab to turn it off or on again.
A donut shows the measure's grand total in its hole by default, using the measure's number format. Use the **Show total** toggle in the Data labels section of the Style tab to turn it off or on again.


{/* Screenshot: Style tab with the Inner radius control highlighted. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
The button appears only for a donut, since a pie has no hollow center to fill.

The total is styled like the slice labels: it uses the font size set in the Data labels section. When labels include **Percentage**, the total shows `100%` on a second line, since the whole is the entire circle.

{/* Screenshot: donut chart with the center total visible, Style tab showing the Show total button. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}

## Color and slice ordering

Expand Down