# Pie and Donut Chart

## Pie and donut charts

Pie and donut charts are a good way to visualise data as a percentage of a total.

### Plot options

You can create pie and donut charts charts from the **PAGE ELEMENTS** section of your workbook's editor panel, or directly from an existing data element. 

<figure><img src="https://files.readme.io/445e066-1.png" alt=""><figcaption></figcaption></figure>

#### Required fields

* **COLOR** (1 column)
* **VALUE** (1+ columns)\
  Columns added to the **VALUE** field are aggregated by default. Aggregation type (e.g. Sum vs Count) is dependent on the original column’s value type (e.g. text, number, date, etc).\
  **Example**: A numeric column \[Sales Amount] will create a new calculated column \[Sum of Sales Amount].

#### Marks

* **TOOLTIP**: choose columns to show when hovering over points in the chart
* **TRELLIS**: select columns to serve as Trellis Rows or Columns, splitting the chart into separate charts

#### Donut hole value

If you're creating a donut chart, you can optionally add a KPI to the hole of the donut.

1. Select the element.

   The editor panel opens to the **Element properties** section.
2. For **Donut hole value**, select the **+** to add a calculation.
3. Add a new column, select the row count, or choose a column to aggregate and display in the donut hole.

   The aggregate value appears with the column name as a default label. You can format the value using the format options.

<figure><img src="https://files.readme.io/2c6d519-better-donut-hole.png" alt=""><figcaption></figcaption></figure>

### Format options

To start editing the format options for a chart:

**Before you start:** This action uses the editor panel. If you have not done so already, open the editor panel from either Explore or Edit mode.

1. In the editor panel, select ![](https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/element-format.svg) **Element format**.
2. Select a format option to view and edit its settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.meetuma.ai/uma-knowledgebase/data-and-reporting/analytics-pro/charts/build-a-chart/pie-and-donut-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.