# 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](https://docs.appfarm.io/reference/apps/data/data-sources) to display as a chart.                                                                        |
| **Filter**                | Apply a [filter](https://docs.appfarm.io/reference/platform-concepts/filters) 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>                              |