Skip to content

Pie / Donut Chart

Introduction

The Pie Chart and Donut Chart widgets allow you to visualize proportions of a whole.
Each slice represents a category’s contribution relative to the total.

  • Pie Chart – Circular chart divided into slices.
  • Donut Chart – Similar to a pie chart but with a hole in the middle for a modern look or to display totals.

These charts are best for showing percentage or proportional data at a glance.

Purpose

To show proportions of categories within a whole.

They are particularly effective when you want to:

  • Highlight relative contribution of each category.
  • Show percentage breakdowns rather than absolute values.
  • Use Donut Chart for better readability when you also want to show the total in the center.
  • Avoid when there are too many categories, as slices become difficult to compare.

Steps to Create a Pie / Donut Chart

  1. From the left vertical menu, select the Charts icon.

    pie

  2. A widget will be automatically added to the Viz canvas.

    pie

  3. Select Dataset

    • From the Datasets dropdown, choose your dataset (e.g., MarketShare.ds).

    • Available columns will be displayed in the Available Columns panel.

      pie


Sample Dataset (MarketShare.ds)

CompanySales
Alpha Corp45000
Beta Ltd30000
Gamma Inc20000
Delta Co15000
Epsilon Group10000

Configuration Steps

  1. Select Chart Type

    • From the Type dropdown in the Properties Panel, choose Pie or Donut.
  2. Assign Category Field

    • Drag a categorical column to the Category field.
    • Defines the slices of the chart.
    • Example: Company
  3. Assign Value Field

    • Drag a numerical column into the Values field.
    • Determines the size of each slice.
    • Example: Sales
  4. Configure Aggregator

    • Click on the Gear icon icon next to the Values field.
    • Choose an Aggregator to define how values are calculated:
      • Count – Number of records.
      • Distinct Count – Unique count of records.
      • Sum – Total of all values.
      • Average – Mean value.
      • Min – Minimum value.
      • Max – Maximum value.
  5. Optional – Color by Column

    • Assign colors by dragging a categorical column here.

    • Example: Color by Company.

      pie


Common Functionalities (Properties Panel)

  • General
  • Labels: Show/hide category names, values, or percentages.
  • Colors: Configure custom palette for slices.
  • Legend
  • Tooltip

Use Case: Employee Performance

Introduction

The Employee Performance use case demonstrates how Pie and Donut Charts can show proportional contributions. By visualizing department-level shares, managers can easily identify which areas contribute most to overall performance.

Sample Dataset (EmployeePerformance.ds)
DepartmentEmployeeScore
SalesJohn85
SalesMary90
HRAnita75
HRRahul82
ITSanjay95
ITPriya88

How to Configure
  • Category -> Department

  • Value -> Score (Aggregator = Sum)

    pie

Business Questions Answered
  • Pie Chart -> What percentage of the total performance score does each department contribute?
  • Donut Chart -> Which department contributes most, and how does the total look in the center?
  • Employee-level Pie Chart -> How do individual employees contribute to the total departmental performance?

Summary

The Employee Performance use case illustrates how Pie and Donut Charts can provide insights into proportions.

  • Pie Chart -> Best for simple breakdowns of a few categories.
  • Donut Chart -> More modern look and supports showing totals in the center.
  • Employee/Department slices -> Help identify major contributors at both levels.