> For the complete documentation index, see [llms.txt](https://docs.toucanai.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toucanai.cloud/build/charts/chart-types/circular-chart.md).

# Circular chart

{% hint style="info" %}
**Target Audience**: Non-technical users and builders configuring charts in the Library.
{% endhint %}

<figure><img src="/files/x1ySOlJHWmWL65iEQRAu" alt="Circular chart example"><figcaption></figcaption></figure>

## 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](/build/charts/chart-types.md#shared-chart-level-settings).

## 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](/build/charts/chart-types/bar-chart.md).
* Trend over time → [Line chart](/build/charts/chart-types/line-chart.md).
* Part-to-whole **per** category (stacked) → [Stacked bar chart](/build/charts/chart-types/stacked-bar-chart.md).
* One KPI → [Value](/build/charts/chart-types/value.md).

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

{% hint style="warning" %}
Keep the number of slices small so labels stay readable.
{% endhint %}

**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](/build/data-connections/how-to/add-a-database.md), Manual Edit ([how-to](/build/charts/how-to/customize-a-chart-manually.md)).

### 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.