> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pie Chart

> Learn about the features, use cases, and basic requirements of the Pie chart component, and how to add and configure one in a report—including selecting a dataset, setting display fields, and adjusting styles.

| **Feature** | **Free plan** | **Basic edition** | **Professional edition** | **Dedicated edition** |
| ----------- | ------------- | ----------------- | ------------------------ | --------------------- |
| Pie chart   | Supported     | Supported         | Supported                | Supported             |

## 1. Introduction

### 1.1 Feature Overview

To visualize the data proportion of each department, use the Pie chart component.

Highlight: You can resize the component and move it freely (left-aligned, center-aligned, or right-aligned).

### 1.2 Use Cases

For example, use angles to represent data proportions, as shown below.

### 1.3 Basic Requirements

The basic requirements for a Pie chart are as follows:

| **Category field** | **Numerical field** | **Trend value field**                  | **Total value field** | **Total trend value field**            | **Total value drill-down icon** |
| ------------------ | ------------------- | -------------------------------------- | --------------------- | -------------------------------------- | ------------------------------- |
| Up to 1 field      | Up to 1 field       | Multiselect supported, up to 30 fields | Up to 1 field         | Multiselect supported, up to 30 fields | Up to 1 field                   |

## 2. Procedure

### 2.1 Select the Component and Configure the Dataset

Create a report, add a Pie chart component, and select a dataset, as shown below.

Select a dataset.

### 2.2 Select Chart Display Fields

Drag the fields on the right into **Category**, **Numerical**, **Trend value**, **Total value**, **Total trend value**, or **Total value drill-down icon**.

* Basic fields

* Premium fields

* Conditional filtering: supported

**You can select fields directly from the dataset or generate them with a formula. For details, see** [**Report formulas**](/yida/form/yrofmw).

Configured example

Configured example

### 2.3 Style Settings

Five sub-categories are available: style configuration, labels, legend, tips, and percent decimal places, as shown below.

#### 2.3.1 Style Configuration

* Adjust the color and size of the Pie chart
* Convert the basic Pie chart into a ring chart
* Adjust the inner radius of the ring chart

Note: When **Group color** is Not Configured, color adjustments under Style take effect.

Custom colors support English color names or hexadecimal values, such as #5894FF. Separate multiple values with commas.

**The inner metric refers to the area circled in red in the figure, as shown below.**

Effect after configuration

#### 2.3.2 Labels

Turn labels On or Close. When On, you can configure the connection line position and display, label size and content, and color (black by default).

**Note: When the position is set to Spider, no color settings are available. Font color can only be set when the position is Outside or Inside.**

Configure labels

#### 2.3.3 Legend

Turn the legend On or Close. When On, you can adjust its position and toggle pagination (On by default).

* Legend type: legend items and Metrics
* Metrics: When the Layout is vertical, you can adjust the ratio of the two columns.

Legend items

Metrics

#### 2.3.4 Tips

Turn Tips On or Close. The effect when On is shown below.

Configure tips

#### 2.3.5 Percent Decimal Places

Set the number of decimal places to display for percentages, as shown below.

Set decimal places

## 3. More Information

This is a Yuque content card. Click the link to view: [https://www.yuque.com/go/doc/49490921](/yida/report/qpdzl5)