# Circular chart (/core/build/charts/chart-types/circular-chart)





<CalloutContainer type="info">
  <CalloutDescription>
    **Target Audience**: Non-technical users and builders configuring charts in the Library.
  </CalloutDescription>
</CalloutContainer>

<img alt="Circular chart example" src="__img0" />

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

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

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

<CalloutContainer type="warning">
  <CalloutDescription>
    Keep the number of slices small so labels stay readable.
  </CalloutDescription>
</CalloutContainer>

**Common setups**

* **Share of total:** **Label** (category) + **Value** with **Sum** or **Count rows**.
* **Time slices:** date **Label** + **Date granularity** + **Value**.

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

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