Chart widget

What it is

Renders a static bar, line, or pie chart from values you enter manually in the config panel.

Config fields

Field	What it controls	Example
Chart Type	Visual style: Bar, Line, or Pie.	Bar
Show Legend	Displays a colour-keyed legend below the chart.	enabled
Labels (comma-separated)	The category labels on the X-axis (bar/line) or slice labels (pie).	Jan, Feb, Mar, Apr
Series label (per dataset)	Display name for one data series.	Revenue
Data (comma-separated) (per dataset)	Numeric values for each label position. Count must match the number of labels.	120, 95, 140, 80
Color (per dataset)	Hex colour for bars, line, or pie slice.	#3b82f6
Add / Remove series	Buttons to add more data series (multiple bars per label group) or remove existing ones. A chart must have at least one series.

Static data only

The Chart widget holds static values that you type in. It does not connect to a database, API, or live data source. Values only change when you edit the widget config manually.

If you need a chart that updates automatically from a live source, embed an external charting tool (Grafana, Metabase, Recharts app, etc.) using the Iframe widget instead.

Common pitfalls

• Label and data count mismatch. If “Labels” has 4 entries but “Data” has 3, the last bar/slice will render as 0 or may be missing. Always keep the counts equal.
• Pie chart with multiple series. Pie charts only render the first dataset; additional series are ignored. Use bar or line for multi-series comparisons.
• Large datasets become unreadable. More than ~12 labels on a bar/line chart starts to look cramped. Consider aggregating or switching to the Metric widget for single-value KPIs.

Troubleshooting

Symptom	Try
A bar/slice is missing	Check that “Labels” and “Data” have the same number of comma-separated values.
Second series not showing on pie	Switch to Bar or Line — pie only renders the first series.
Legend overlaps chart	Disable “Show Legend” if space is tight; the chart fills the tile without it.