Your first Live Task List
Time: 5 minutes. You'll need: any wiki page in a workspace where you can create tasks, and a handful of open tasks (three or four is enough).
By the end you will have a wiki page with an embedded Live Task List that refreshes on its own, so anyone who opens the page sees the current state of the work without you editing anything.
1. Open a wiki page for editing
From the left rail, open Wiki. Pick any page (or hit New page and give it a title like "Auth rework: remaining scope"). Click into the page body so the editor is focused.
2. Insert a Live Task List block
On the editor toolbar, click the Sparkles button. A new Live
Task List block appears in the page and immediately fetches its
default filter (everyone's open work in the workspace, capped to 10
rows). You should see one row per open task, with state icon, project
chip like PAR-482, title, priority, and first assignee.
3. Rename the block
Click the block's title (it reads "Live task list" by default). It turns into an inline text input. Type something readers will understand at a glance, for example "Remaining scope for the auth rework". Press Enter to commit (Escape cancels).
4. Scope it with the filter builder
Click the gear icon on the block header. The filter picker opens inline with four controls:
- State: checkboxes for backlog, unstarted, started, completed, cancelled. Pick unstarted and started for "open work".
- Assignee: anyone, or "me" (renders the current viewer's own work, not yours; every reader sees their own list).
- Priority: checkboxes for urgent, high, medium, low, none.
- Limit: a number between 1 and 100.
Click Apply. The list updates in place. A chip row appears under the header summarising any non-default filter, so a reader sees at a glance what is being shown.
If you need to filter by project or label, use the query-param API directly (see the Reactive documents page for the full filter surface); the in-block picker covers the common cases and grows in v2.
5. Save the page
Save the wiki page. Open it in another tab (or ask a teammate to open it). The block renders live for every reader; the auto-refresh runs every 30 seconds. If you close a task in the tracker, the row drops from the list on the next refresh, on every open reader.
What next
- Reactive documents: full filter
surface, the public API mirror at
GET /workspaces/{slug}/reactive/issues/, and the v2 roadmap. - Wiki: the underlying editor and access model, including per-collection permissions.