Dashboard widgets
Every widget you can put on a dashboard, what it shows, and how to bind it to your data.
Open the widget palette with Add block on a dashboard. Everything below is also available on a page — see Blocks in a page.
Data widgets
| Widget | What it shows | Bind it to |
|---|---|---|
| Metric | One number — a count, sum, average | A database, a field, an aggregate |
| Bar chart | A metric drawn as bars | A database, grouped by a field |
| KPI number | A large single figure, for the top of a board | A database aggregate |
| Database view | A live table, board, or calendar inline | A database and one of its views |
| Insight brief | A short written summary generated over your data | A database |
| Activity | Recent workspace activity | The workspace |
For anything richer than a bar — line, donut, horizontal bar, or a number card with a reference line — use a Chart view on the database itself and embed it with Database view. See Every view type.
Interactive widgets
| Widget | What it does |
|---|---|
| Control | An input (text, select, date) that writes a dashboard parameter. Other widgets filter by it |
| Live text | Text with parameters and data interpolated into it |
| Button | Runs an action when clicked |
| Tabs | Splits the board into named sections |
Embeds
| Widget | What it shows |
|---|---|
| Form | One of your forms, submittable in place |
| Drive | Files from a connected drive |
| Page preview | Another page, as a card |
Layout
Heading, Text, Horizontal divider, and Vertical divider — for labelling and separating sections of the board.
Wiring widgets together
The pattern that makes a dashboard genuinely useful:
- Add a Control and give its parameter a name, e.g.
owner. - Point widgets at that parameter so they filter by it.
- Add a Live text heading that interpolates
owner, so the board says what it’s currently showing. - Add a Button bound to an action for whatever people do next — create the record, refresh the source, kick off the automation.
That is the whole loop: see the state → change the lens → take the action, without leaving the board.
Sizing
Widgets snap to a 12-column grid. Drag the corner to resize. A metric usually wants 3–4 columns; a database view wants 8 or the full 12.