Search documentation

Search docs pages by title or description

Join the waitlist
Browse documentation

Chart block

Metric

The chart block groups a table by one field and plots an aggregate per group — deals by stage, revenue by month, tickets by assignee — as a bar, line, or donut chart.

Try it: Switch the chart type and the group-by field, then hover a bar, point, or slice to read its value.
Settings
Revenue by month
€0€2.5k€5.0k€7.5k€10.0kJanFebMar
Example. A chart block over an Orders table. Grouped by the Created month it sums Amount per month; grouped by the Channel select field it counts orders per option. Bars and lines share one dashed grid and muted axes; the donut takes the app theme's chart colors in option order.

When to use it

  • Distributions: how records split across a select field's options.
  • Trends over time — group by a date field with a line chart.
  • Share-of-total questions, where the donut's proportions tell the story.

Settings

SettingWhat it does
Chart typeBar for comparisons, line for trends, donut for shares of a whole.
Group byThe field whose values become the bars, points, or slices.
FunctionThe aggregate computed per group.
FieldThe field the function runs over — required for everything except count.
Pair a chart with a filter block and viewers can slice the same chart by date range, category, or owner without you building variants.

Like every block, this one also has the shared block settings: a title and optional description, a header you can show or hide, auto-height, conditional visibility, and role-based visibility, plus the source table and record-filter settings shared by all data blocks.