Skip to content

Pie charts

There are four pie chart components available in Dashboard Publisher. All pie chart components must be connected to a data source.

Displays the relation of a part to a whole, or a proportion of one variable in relation to others.

Similar to a Pie Chart, but with data presented in a ring.

Similar to a Donut Chart, but with data presented in a half circle corresponding to 100%.

Values are represented as individual dots arranged in a semicircular arc.

  • Component Name — enter a label for the component (optional). The label will not be visible in the dashboard; it is useful for identifying components quickly while laying out your dashboard.
  • Chart Format — set the Title (default “Chart Title”), Title Colour, Sub Title, Sub Title Colour and Font.
  • Size — set the component’s Fill and Height.
  • Chart Settings — includes:
    • Downloadable Data — adds an export menu to the chart so viewers can download it as a JPEG, PNG or Excel file. It’s off by default.
    • Data Sorting — None, Ascending or Descending.
    • Tooltips, with Tooltip Number Format and Tooltip Number of Decimals (default 1).
    • Show Data Labels, with Data Labels Colour, Data Label Number Format and Data Label Number of Decimals (default 0).
  • Colours — there are 10 default colours pre-set in Dashboard Publisher. You can change any or all of these by clicking the arrow next to each colour.
  • Legend — configure the legend settings. The legend is off by default.
  • Border and Background — add borders and/or background colours to the component.

Pie charts don’t have axes, so there are no Horizontal Axis or Vertical Axis settings.

Each pie chart takes one data source. Pie charts don’t ask for a supporting variable.

After the data source is connected, you can still change these settings on the DATA SOURCE tab:

  • Decimal Places
  • Format with commas
  • Suppress Nulls (Pie Chart, Donut Chart and Semi Circle only)

The data source also has its own filter bindings on the DATA SOURCE tab. See Dashboard filters for details.


Can I add multiple data sources to a pie chart?

No. All pie chart components (Pie Chart, Donut Chart, Semi Circle, and Item Chart) accept a single data source only.

What aggregation types do pie charts support?

The Pie Chart, Donut Chart and Semi Circle support NPS, CSat, and Categorical aggregation types. The Item Chart supports NPS and CSat only. None of the pie chart types support Mean or Percentage.

When should I use a Semi Circle instead of a Donut Chart?

A Semi Circle presents data in a half circle where the total always corresponds to 100%. This can be effective when you want to emphasize a single metric against its maximum, such as a satisfaction score. A Donut Chart shows the full ring, which works better for displaying multiple categories and their relative proportions.

Can pie charts connect to data explorations?

Yes. All four pie chart types support connecting to data explorations as well as data stores.

Why doesn’t my pie chart show a legend?

The legend is off by default. Turn it on in the Legend properties.

Can I display a value in the centre of a donut chart?

Yes. Place a Single Value Tile component on top of a Donut Chart by positioning both inside the same container. Size and position the tile so it sits in the centre of the donut. Connect the tile to the same data source to display the relevant value.

How can viewers download a chart or its data?

Turn on Downloadable Data under Chart Settings. The chart then shows an export menu where viewers can download it as a JPEG, PNG or Excel file.

Why does my chart show an error icon instead of data?

This happens when a field the chart uses has since been excluded from exports and AI. Excluded fields are withheld from Dashboard Publisher, so they no longer appear in the variable pickers, and charts that already use them show an error icon. Connect the chart to a different variable, or ask the data owner whether the field can be included again.