> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pie Chart

> Categorical share of a whole.

<Frame caption="A pie chart broken down by segment.">
  <img src="https://mintcdn.com/custral/NGCdls_pt-1YDx5S/images/charts/pie.png?fit=max&auto=format&n=NGCdls_pt-1YDx5S&q=85&s=c72bc65e28372c2605a8f5701877be2f" alt="A pie chart broken down by segment." width="760" height="420" data-path="images/charts/pie.png" />
</Frame>

## When to use

Pie charts answer "what share of the total is X?". The center is filled (no donut). Pick Pie over Donut when you don't need the center for a headline metric.

## Required data shape

Same as Donut. A categorical group property and an optional aggregated value.

## Configuration

| Setting     | What it does                                                        |
| ----------- | ------------------------------------------------------------------- |
| Group by    | The property whose values become the pie slices.                    |
| Value       | The numeric value aggregated per slice. Defaults to a record count. |
| Aggregation | How values roll up: Count, Sum, or Average.                         |

## Limitations

* Five or fewer categories.
* Like Donut, pies are bad at communicating precise differences. For exact comparison, use Bar.


## Related topics

- [Chart drill-down](/bi/reporting/drill-down.md)
- [Treemap](/bi/reporting/charts/treemap.md)
- [BI Best Practices](/bi/best-practices.md)
- [Reporting](/bi/reporting/overview.md)
- [Blocks](/blocks/overview.md)