Help center Get started Knowledge center Product documentation API documentation
Product
Lens Weave Maskbits
Overview
Design
Project
Chart Designer
Visualization
Table Bar Chart Horizontal Bar Chart Stacked Bar Chart Horizontal Stacked Bar Chart Area Chart Line Chart Funnel Chart Pie Chart Donut Chart Waterfall Chart Radar Line Chart Numbered Card Semi Gauge Chart Radial Gauge Chart Linear Gauge Chart Financial Chart Full Gauge Chart Form View Pivot Table Box Plot Chart Geo Chart Tree List Tree Map Sankey Chart Bubble Chart Pyramid Chart
Analytics
Metrics Analysis
Custom Scripts Dimensions Filters Reports
Library
Charts Reports Templates
Dashboard
Dashboard
Schedule
Scheduler
Inbox
Inbox
Migration
Migration
Datasource
Datasource
Datasource Management
Data Model
Connectors Management
Admin
Admin
User Management Roles Management Group Management Organization Management Security Tags

Overview

A Donut Chart renders dataset values as wedge segments of a ring and is visually identical to a Pie Chart with a hole in the middle. The open center can hold an aggregate value, a brand mark, or a title, leaving the ring to carry the part-of-whole story. Configuration mirrors the Bar Chart entirely except for axis-related properties (no Donut equivalent).

Donut Charts are authored from Lens → Design → Chart Designer → Visualization → Donut Chart. A 3D variant is available via the 3D Donut icon in the Properties tab, matching the Pie Chart pattern. This page documents the Donut-specific behavior; for property and column configuration, see the Bar Chart PD reference.

When to use it

  • Part-of-whole comparisons across a small number of categories where the visual style of a Pie Chart is desired but with center space for a value or label.
  • Dashboards where the center of the chart should display a KPI, an aggregate, or branding content.
  • Presentation contexts where a Donut reads more modern or compact than a Pie.
  • A 3D rendering of the same Donut Chart is desired for presentation purposes.

Relationship to Pie Chart and Bar Chart

Donut Chart is functionally the same chart as Pie Chart with a hole in the middle. It inherits all configuration from the Bar Chart (with axis-related properties not applying), in the same way the Pie Chart does.

Properties tabTitle, Legend Position, Tooltip Options, Background, Label Position, Padding, Randomized Color, Miscellaneous (Adhoc Report). Axis-related properties (X-Axis, Y-Axis, Multi-Axis) have no Donut equivalent.Bar Chart PD → Properties tab
Columns tabHeader, Display Name, Content Properties, Sorting & Filter, Image, Tooltip Options, Type, Drilldown, Aggregate, Column Settings, plus the Bar-specific Tool Tip, Outline, Gradient, Label Rotation.Bar Chart PD → Columns tab
Center spaceThe Donut’s defining feature is an open ring with the center. The center can display a KPI, an aggregate, or branding content.  —

Key behaviors

Donut is Pie with a center hole. Donut and Pie are functionally the same chart type. The same data, Dimension, and Measure assignments produce equivalent visualizations and the only difference is the open center on Donut. Same low-cardinality recommendation, same single-Measure expectation, same axis-property exclusions.

Center space utilization. The open center is the Donut’s design rationale is that it leaves room for a value, label, or other content that wouldn’t fit on a Pie.

Best for low-cardinality, single-Measure data. Like Pie Charts, Donuts compress visually as category count grows. For larger category counts prefer Bar Chart; for multiple Measures prefer Bar Chart or Stacked Bar Chart.

Use Donut for share with center content; use Pie for share without. Donut and Pie are interchangeable for the part-of-whole narrative. Pick Donut when the center space is useful (KPI, label, branding); pick Pie when the visualization is the whole story and the center isn’t needed.