chart
Draws a source's rows as an area, line, bar, donut or spark chart, such as tickets closed per hour or where the money goes.
kind picks the shape: line or area for a value over time, bar to compare a few categories, donut for the
parts of one whole, spark for a small trend without axes. x is the column along the bottom (a time or a label)
and series the 1 to 5 number columns drawn, one row per point in the source's order (sort it with the source's
order). format writes the values as kpis do. title names the chart in a few words.
When to use
Use it when
A value over time, such as tickets closed and handed off per hour today.
A few categories compared, such as this month's spend by category.
The parts of one whole, such as where the money goes.
Use another block when
Use kpis
Use progress
Closed and handed off per hour
Closed per hour today
chart: { title: Closed per hour today, kind: bar, source: hourly, x: hour, series: [closed, handed_off] }
<a id="chart-1"></a>
**Closed per hour today** — bar chart, 3 points, hour 08:00 … 10:00
- closed: 31–52
- handed_off: 3–6
Where the money goes
Where the money goes this month
chart: { title: Where the money goes this month, kind: donut, source: spend, x: category, series: [usd], format: usd }
<a id="chart-1"></a>
**Where the money goes this month** — donut chart, 4 points, category Agent results … Hosting
- usd: $780–$6,140
Daily cost this week
Model cost per day
chart:
title: Model cost per day
kind: area
source: daily
x: day
series: [cost_usd]
format: usd
<a id="chart-1"></a>
**Model cost per day** — area chart, 4 points, day 2026-10-27 … 2026-10-30
- cost_usd: $188–$231
States
ready
the source's rows, drawn
empty
the source has no rows: an Empty part saying so
error
the source failed: the block shows the source's sentence; the page still answers 200
This block offers no actions; it only shows.
JSON Schema