# Basic pie chart

The Basic Pie Chart displays data in a circle divided into segments or slices, which are proportional to the represented values.

## Usage

Basic Bar Charts are used to show data as a percentage of a whole. 

## Properties

| Property                  | Description                                                                                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Data Source**           | Select a [data source](/reference/apps/data/data-sources.md) to display as a chart.                                                                                            |
| **Filter**                | Apply a [filter](/reference/platform-concepts/filters.md) to the selected data source.                                                                                         |
| **Conditional Filters**   | Create conditional filters to apply to the selected data source.                                                                                                               |
| **Category Property**     | Select a data source to display as slices in the chart. Only the data types Boolean, Enumerated Types and Datetime are supported.                                              |
| **Use Enum Colors**       | <p>Visible when <strong>Category Property of type Enumerated Type</strong> is selected.</p><p><br>Enable to use the colors defined in each Enum Value.</p>                     |
| **Group By**              | <p>Visible when <strong>Category Property of data type Datetime</strong> is selected.</p><p></p><p>Select a dimension to group the data by. By default, Month is selected.</p> |
| **Value Property**        | Select a data source to aggregate the data on. If no data source is selected, count will be used by default.                                                                   |
| **Title**                 | Enter a static title or bind it to a data source, function, date now or date today.                                                                                            |
| **Title Position**        | <p>Visible when <strong>Title</strong> is selected.</p><p><br>Position the title on the top, left, bottom or right side of the chart.</p>                                      |
| **Show Legend**           | Enable to show a legend.                                                                                                                                                       |
| **Legend Position**       | <p>Visible when <strong>Show Legend</strong> is enabled.</p><p><br>Position the legend on the top, left, bottom or right side of the chart.</p>                                |
| **Doughnut Cutout**       | Select the percentage for the cutout in the middle of the circle.                                                                                                              |
| **Show Empty Categories** | <p>Visible when <strong>Show Legend</strong> is enabled.<br></p><p>Enable to show an empty category in legend.</p>                                                             |
| **Show Uncategorized**    | <p>Visible when <strong>Show Legend</strong> is enabled.</p><p><br>Enable to display uncategorized data as a separate category in the legend.</p>                              |


---

# 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://docs.appfarm.io/library/ui-components/basic-pie-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.