---
title: "Pie"
description: "A circular chart divided into slices to illustrate proportional data, with options for labels, gradients, and rose-type variations."
group: Charts
tags: [Visualization, Chart, Dashboard, Pie, Distribution, Proportions]
---
import { Aside, Steps } from '@astrojs/starlight/components';
# Pie
The **Pie Chart** represents data as slices of a circle, where each slice’s size is proportional to its value relative to the total.
This chart is ideal for showcasing **proportional relationships** within a dataset.
It can be configured as a standard pie or **Rose (Nightingale) chart**, where slice radii or areas can vary based on value magnitude.
**Use cases:**
- Displaying **percentage share or contribution** of categories.
- Highlighting **dominant or minor segments** in a distribution.
- Using **rose-type mode** to compare category magnitude via radius or area.
---
## ⚙️ Setup
1. Drag the **Pie Chart** widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the [Widget Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/) tab in the Configuration panel.
4. Under the Configuration panel tab, select the [Basic Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/#basic) option to access essential settings for the Pie Chart.
5. Select the [Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources) from which the chart will fetch its data.
6. Map:
- **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Numeric value representing the size of each slice.
- **[Dimension](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Categorical value determining each slice.
7. Optionally add a **Date** field for time-based filtering.
---
## 📊 Basic Configuration
| Configuration Item | Description |
|:---------------------|:-------------|
| **[Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources)** | The data source to query for chart values. |
| **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** | Numeric value plotted as each slice’s size. |
| **[Dimension](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** | Categorical value determining each slice. |
| **Date Field** (optional) | Enables date-based filtering and drilldown capability. |
---
## 🎨 Chart Customizations
| Category | Options & Description |
|:----------------------------|:-----------------------------------------------------------|
| **[General](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#general)** | Theme, background, border, and interactivity options. |
| **[Title](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#title)** | Chart title, font, alignment, and visibility settings. |
| **[Sorting](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#sorting)** | Control sorting of pie slices based on value or category. |
| **[Position](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#position)** | Adjust horizontal and vertical positioning of the pie within the chart. |
| **[Legend](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#legends)** | Show/hide, position, and format for the pie slice labels. |
| **[Series](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#series-customization)** | Configure slice labels, rotation, colors, gradient fills, and positioning. |
| **[Tooltip](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#tooltip)** | Tooltip content, format, and triggers for slices. |
| **Others** | Control **slice overlap hiding**, **clockwise direction**, **radius**, **inner radius (donut)**, **border rounding**, **start angle**, and **Rose chart mode** (by radius/area). |
---
## 📊 Example Visualization
