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 Pie Chart renders dataset values as wedge segments of a circle, sized in proportion to each category’s contribution to the whole. It is the standard visualization for part-of-whole comparisons across a small number of categories. Configuration mirrors the Bar Chart entirely except for axis-related properties (which have no Pie equivalent).

Pie Charts are authored from Lens → Design → Chart Designer → Visualization → Pie Chart. A 3D variant is available via the 3D Pie icon in the Properties tab. This page documents the Pie-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 (typically up to six or seven).
  • Single-Measure breakdowns where the relative share of each category is the story.
  • Presentation contexts where a circular visualization reads more naturally than rectangular bars.
  • A 3D rendering of the same Pie Chart is desired for presentation purposes.

Relationship to Bar Chart

Properties and Columns customization on the Pie Chart is identical to the Bar Chart, with two exceptions noted below.

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 Pie 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

Key behaviors

Rendering is the only structural difference. A Pie Chart is functionally identical to a Bar Chart with one rendering difference: data renders as proportional circle wedges rather than bars. Configuration that applies to bar-shaped output (Bar Shape, axis configuration, Multi-Axis) doesn’t map directly to a Pie Chart, but the rest of the surface is shared.

Best for low-cardinality, single-Measure data. Pie Charts visually compress as category count grows — wedges become indistinguishable and labels overlap. The chart is well-suited to single-Measure data with a small number of categories. For larger category counts, prefer Bar Chart; for multiple Measures, prefer Bar Chart or Stacked Bar Chart.

Single Measure expected. A Pie Chart shows one Measure across the Dimension’s categories.

Use Pie for share; use Bar for comparison. Pie Charts emphasize the share each category contributes to the total and the visual area difference is the message. Bar Charts emphasize the discrete values themselves. Pick Pie when the narrative is “what fraction of the whole is each category”; pick Bar when the narrative is “what are the values.”