> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-refactor-full-audit-reorg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pie chart

> Use pie charts to visualize data that adds up to a meaningful whole.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/-DvjDw66zBvkz4sP/images/explore/chart-types/pie-chart/pie-chart.png?fit=max&auto=format&n=-DvjDw66zBvkz4sP&q=85&s=e394793d0c49ee9f56aa10a3f8ed9475" alt="" width="1892" height="1350" data-path="images/explore/chart-types/pie-chart/pie-chart.png" />
</Frame>

Pie charts can be useful to visualize data that adds up to a meaningful "whole". For example, the split of total revenue across each of our product lines.

To use a pie chart, you need at least one metric and one dimension in your query results. You can add multiple dimensions to create more granular groups in your pie charts.

By default, pie charts are shown in a donut shape (i.e. with the center removed) but you can easily toggle the `donut` toggle to switch between a traditional pie and donut chart.

## Referencing the active granularity in labels

Labels support a `${table_field.granularity}` placeholder that resolves to the active date granularity — for example `day`, `week`, or `month` — including the granularity a viewer selects with [date zoom](/explore/date-zoom). Click the **insert date granularity** icon inside the editable label field to add it without typing. See [Referencing the granularity in chart labels](/explore/date-zoom#referencing-the-granularity-in-chart-labels) for the full syntax and the complete list of supported labels.

<Warning>
  These labels are per-category overrides keyed to a specific value. Date zoom re-buckets the underlying dates — a monthly `2024-07` category becomes a weekly `2024-07-15` category — so an override set at one granularity stops matching after a viewer zooms to another, and the label silently falls back to the raw value.
</Warning>

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/sZ3fMhsuFhRy0pFs/images/Screenshot-2026-06-25-at-12.16.04.png?fit=max&auto=format&n=sZ3fMhsuFhRy0pFs&q=85&s=141dc45dde0b4e2c6e3b078ec60a8d43" alt="Screenshot 2026 06 25 At 12 16 04" width="740" height="392" data-path="images/Screenshot-2026-06-25-at-12.16.04.png" />
</Frame>
