list
A short list of lines, each a title with an optional subtitle and link, read from a source or written as items.
Either source with the columns it shows (title required, subtitle and href optional), or items, 1 to 200
lines written in the YAML, each { title, subtitle, href }. Exactly one of the two. An href is an https://
URL or a path starting with /. Lines show in the source's order; at most 200.
When to use
Use it when
A few things with one line each, such as the tools still rented and when they renew.
Links a person needs next to the work, such as runbooks.
The items of a "when to use" list on a reference screen.
Use another block when
Events in time order with who did them.
Use timeline
One link that starts the next step.
Use button
Tools still rented
Expense tool
Renews on 1 December
Remote support seats
Renews on 15 January, 40 seats
list: { source: tools, title: name, subtitle: detail }
<a id="list-1"></a>
- Expense tool — Renews on 1 December
- Remote support seats — Renews on 15 January, 40 seats
Runbooks, with links
Network
Identity
list: { source: runbooks, title: title, subtitle: team, href: url }
<a id="list-1"></a>
- [VPN profile reset](https://docs.example.com/runbooks/vpn) — Network
- [MFA reset on a new phone](https://docs.example.com/runbooks/mfa) — Identity
Next steps, written in place
Retest the Apps agent on this week's tickets
Hand-offs tripled since Monday
list:
items:
- { title: Review the 27 tickets that need a person, href: /a/service-desk/queue }
- { title: Retest the Apps agent on this week's tickets, subtitle: Hand-offs tripled since Monday }
<a id="list-1"></a>
- [Review the 27 tickets that need a person](/a/service-desk/queue)
- Retest the Apps agent on this week's tickets — Hand-offs tripled since Monday
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