Pie Chart Widget

The pie chart widget can display a single dataset with corresponding proportions, or multiple datasets with nested proportions.

A pie chart widget. The innermost ring shows the user's country, and the outermost ring is segmented proportionally to show the share of browsers used in each country.


  1. Select from the available data sources.
  2. Configure the query, see the following resources for more information:
    • Metrics: See the querying documentation to configure a metric query.
    • Events: See the log search documentation to configure a log event query.
  3. (Optional) Modify query with a formula.
  4. Customize your graph.

Graph customization

Total amount display

Toggle whether to show a total count in the center of the chart. By default, the Automatic option shows the total count once the graph reaches a certain size.

Legend configuration

The legend can be turned off, displayed directly over chart segments with the Aside option, or as a Table listing each value, its color, and proportion.

By default, the Automatic option shows a labeled Aside legend within a dashboard, and displays both the Aside and Table legends when opened in full-screen.

Pie chart Legend and Labeling options: Automatic, Table, Aside, and None

Context links are enabled by default, and can be toggled on or off. Context links bridge dashboard widgets with other pages (in Datadog, or third-party).

Display and interaction

Filter and focus

In the case where multiple groups of data are plotted at once, you can choose a single category and view proportions within it.

To view a single category, hover over the outer portion of the category ring, and click. To go back to the previous view, move your cursor to the center of the chart and click.


Viewing the pie chart widget in full-screen reveals the standard set of full-screen options.


This widget can be used with the Dashboards API.

Treemap widget

Like the pie chart widget, the treemap can also be used to display nested proportions. The primary difference between the two is that the pie chart displays proportions in radial slices, and the treemap displays nested rectangles.

Further Reading

Additional helpful documentation, links, and articles: