Circular chart

Configure a circular (pie or donut) chart in Toucan AI to show proportions of a whole.

Target Audience: Non-technical users and builders configuring charts in the Library.

Overview

A circular chart shows how a measure is split across labels (slices). Each slice is one value of the dimension; slice size comes from Value.

• Dimension: Label — the column that defines each slice.

• Measure: Value — one query column, with optional Aggregation.

In the Library, enable Manual Edit, set Type to Circular, and map columns under Data.

Shared fields (Title, Narrative, Data) are in Chart types.

When to use it

Good fit

• Shares of a limited number of categories (market share, budget mix).

• Proportions that sum to a meaningful whole.

• Quick comparison of a few segments.

Prefer another chart

• Many categories or precise comparison → Bar chart.

• Trend over time → Line chart.

• Part-to-whole per category (stacked) → Stacked bar chart.

• One KPI → Value.

Examples: market share by region, tickets by priority, budget by department.

Keep the number of slices small so labels stay readable.

Common setups

• Share of total: Label (category) + Value with Sum or Count rows.

• Time slices: date Label + Date granularity + Value.

Configuration options

Open the chart in the Library, turn on Manual Edit, select Data, then set Type to Circular. Panels: Dimension and Measure.

Prerequisites: connected database, Manual Edit (how-to).

Dimension

Option	How it works
Label	Column for each slice (category, region, etc.).
Date granularity	Only shown when Label is a date column. Year, Quarter, Month, Week, or Day.
Date format	Only shown when Label is a date column. How dates appear in slice labels.

Measure

Option	How it works
Value	Column for slice size. Often numeric; use Aggregation (e.g. Count rows) otherwise.
Aggregation	Reduces rows before plotting (see below).
Format number	Shown when the measure is numeric (after aggregation). Standard, Percent, Currency, decimals, Unit.

The AI assistant can pre-fill Label and Value; use Manual Edit to adjust.