Documentation

The Pie widget visualizes how a metric is distributed across dimension values — each slice represents one category's share of the total. The use cases below show how to build and configure it.

Build your pie chart

1. Add a Pie widget to your dashboard

Display a proportional breakdown of a metric split by category.

1. Open your dashboard in edit mode.
2. Click Select a default data table in the header and choose your data source (e.g. cross_channel_automated_recipe).
3. Click + Pie in the bottom toolbar. The widget appears on the canvas and the Properties Panel opens automatically.
4. In the Data section, click a metric (e.g. Spend) and a dimension (e.g. Channel).
5. Close the Properties Panel to see the finished widget.

Result: The pie chart renders with colored slices, one per dimension value. The default title is Distribution Chart.

2. Select a dimension and metric

Choose which categorical field defines the slices and which numeric metric determines their size.

1. Open the Data section in the Properties Panel.
2. In the Dimensions picker, click a categorical field (e.g. Data Source Type, Campaign Name).
3. Click a metric to set the value each slice represents (e.g. Spend, Clicks).

Result: Each slice represents one unique dimension value. Slice size reflects that value's share of the total. A legend maps slice colors to dimension names.

Customize the display

3. Switch between pie and donut style

Adjust the inner radius to change the chart from a full pie to a donut ring of any thickness.

1. Open the Properties Panel and go to the Basics or Appearance section.
2. Find the Inner Radius slider.
3. Set the value to 0 for a full pie with no center hole.
4. Increase the value to 40 or higher to create a donut shape with a visible center hole.
5. Increase further (e.g. 60–70) to make the ring thinner.

Result: A value around 40–50 creates a standard donut chart. Higher values produce a thinner ring. The chart must have data loaded before the visual change is noticeable.

4. Configure labels, percentages, and values

Control which information appears on each slice — dimension name, percentage share, and raw metric value — and where labels are positioned.

1. Open the Layout section in the Properties Panel.
2. Use the Show Labels toggle to show or hide labels on each slice.
3. Enable Show Percentages to add a percentage share to each label (e.g. 45%).
4. Enable Show Values to add the raw metric value alongside the label.
5. Use the Label Position selector to place labels Inside slices or Outside with connector lines.

Result: Labels show the dimension name, percentage, and raw value depending on which toggles are active. Outside position adds lines connecting labels to their corresponding slice.