Create Pie chart
Everything you need to know to create the chart you want.
Overview
Pie charts display parts of a whole as slices around a circle. They’re best for showing simple composition where there are few categories and a clear story.
When to use it
Illustrating percentage breakdowns with ≤5 slices.
Highlighting a dominant slice versus the rest.
Presenting categorical distribution in executive summaries.
Avoid pie charts for detailed comparisons, many categories, or values that don’t sum to a meaningful whole. Consider bar or stacked charts instead.
Data requirements
One series of positive values.
Categories should represent mutually exclusive segments.
Ideally, values sum to 100% (but not strictly required).
Style options available
Colors
Color palette
palette
—
Palette applied to series; sets the default colours for the chart.
General → Pie
Start angle, deg
number
—
Angle where circular charts begin drawing, in degrees.
General → Pie
End angle, deg
number
—
Angle at which circular charts (pie, donut, gauge) stop drawing, measured in degrees.
General → Pie
Margin between slices
number
—
Gap between adjacent pie or donut slices.
General → Pie
Enable sorting
boolean
—
Automatically sorts points by value before plotting.
General → Data labels
Show data labels
boolean
—
Shows numeric labels directly on data points.
General → Data labels
Distance from pie, %
text
—
How far a slice is pulled out from the centre as a percentage of radius.
General → Data labels
Show name of series
boolean
—
Shows series names alongside values (used in waterfall totals).
General → Data labels
Allow labels to overlap
boolean
—
Allows labels to render even if they collide instead of hiding them automatically.
General → Data labels
Font name
text
—
Font family used for titles, labels, or legend text.
General → Data labels
Font style
text
—
Font weight or style (e.g., bold, italic).
General → Data labels
Font size
number
—
Font size in pixels for the selected text element.
General → Data labels
Font color
color
—
Colour of the text shown for this element.
Legend → Main
Show legend
boolean
—
Shows or hides the legend box.
Legend → Main
Horizontal align
select
left, center, right
Horizontal alignment for the legend box (left, centre, right).
Legend → Main
Vertical align
select
top, middle, bottom
Vertical alignment for the legend box (top, middle, bottom).
Legend → Main
Layout
select
horizontal, vertical, proximate
Orientation of the legend items (horizontal row, vertical column, or proximate).
Legend → Additional
Margin for legend
number
—
Outer margin around the legend box.
Legend → Additional
Margin top for items
number
—
Top padding inside the legend between items.
Legend → Additional
Margin bottom for items
number
—
Bottom padding inside the legend between items.
Legend → Additional
Distance between items
number
—
Horizontal spacing between legend entries.
Legend → Style
Font name
text
—
Font family used for titles, labels, or legend text.
Legend → Style
Font style
text
—
Font weight or style (e.g., bold, italic).
Legend → Style
Font size
number
—
Font size in pixels for the selected text element.
Legend → Style
Font color
color
—
Colour of the text shown for this element.
Title → Chart title
Font name
text
—
Font family used for titles, labels, or legend text.
Title → Chart title
Font style
text
—
Font weight or style (e.g., bold, italic).
Title → Chart title
Font size
number
—
Font size in pixels for the selected text element.
Title → Chart title
Font color
color
—
Colour of the text shown for this element.
Title → Chart title
Margin bottom
number
—
Extra space below chart titles or subtitles in pixels.
Title → Chart subtitle
Font name
text
—
Font family used for titles, labels, or legend text.
Title → Chart subtitle
Font style
text
—
Font weight or style (e.g., bold, italic).
Title → Chart subtitle
Font size
number
—
Font size in pixels for the selected text element.
Title → Chart subtitle
Font color
color
—
Colour of the text shown for this element.
🍰 Tip: Sort slices from largest to smallest (clockwise) so the story is easy to grasp at a glance.
Have problems or want to improve this chart type?
Ping us via [email protected].
Last updated