Views, the filter bar and swimlanes
The filter bar narrows the board to the cards you want, and a view saves that filter with a layout so you can come back to it: “My cards this cycle”, “Blocked”, “Needs review”. Saved views are listed in the sidebar under Views. Swimlanes split the board into a row per team or per project.
Filter the board
- Press
Fon the board, or click the filter bar under the toolbar. - Type a token such as
label:bug. The bar suggests keys first, then values. A finished token becomes a chip. - Add more tokens. Each key narrows the board further.
- To change a chip, press Backspace in the empty input: the last chip comes back as text. × clears the bar.
Without a view open, the bar and the layout are yours and the board remembers them.
What you can type
| Write | Means |
|---|---|
label:bug |
has the label |
label:bug,ui |
either label: values in one key are OR’d, and separate keys are AND’d |
-status:done |
not this |
project:"Web site" |
quotes for a value with a space |
login oauth |
every word appears in the title, notes, labels, project, team or tracker key |
project: / team: |
by name or id; none for cards with no project or team |
role: |
the column, by its role: backlog, ready, working, review, done |
status: |
the run: running, queued, needs-input, waiting, needs-you, failed, blocked, review, done, idle |
assignee: / owner: |
me, none, a name or an id. A card has one owner, so both read it |
priority: |
urgent, high, low, none, or a comparison: >=high, <2 |
due: |
overdue, today, week, none, a date, or a comparison: <2026-12-01 |
has: |
run, pr, outputs, due, owner, label, link, attachments |
cycle: |
current and next (each card’s own team’s), a cycle’s name, or none. See Planning |
estimate: |
a number or a comparison (3, >=5), or none. T-shirt sizes count as 1 to 5 |
field: |
a custom field: field:severity=high, field:effort>=3. See Custom fields |
recipe: (or kind:) |
the recipe that runs the card, by slug, name or id, or none. recipe:study lists every study |
Pick a layout
The layout switch in the filter bar has three layouts:
- Board: the columns, filtered. You order cards by dragging them, so grouping and sorting don’t apply.
- List: one row per card, with its tracker key, title, column, run, assignee, estimate and due date. Group by
column, project, assignee, priority or cycle. Sort by board order, priority, last updated, created, due date, title
or a custom field.
JandK(or the arrow keys) move,Enteropens a card, andXpicks it. At phone width each row is a plain two-line item. - Timeline: projects as rows, milestones as diamonds and dated cards as bars. See The timeline layout.
Save a view
- Set the filter, the layout, and the grouping and sort if you use the list.
- Press ⌘S (Ctrl+S), or click Save view.
- Give it a Name. If you are an owner or admin, turn on Share with the org to share it.
- Click Save view. The view opens and appears in the sidebar under Views. The plain board’s filter bar is cleared, because the filter now lives in the view.
To change an open view, edit the filter and press ⌘S again. The view’s button shows a dot while there are unsaved changes. Its menu has Save changes, Save as a new view…, Edit view… (name, sharing, layout, grouping, sort), Delete view (with Undo) and Close view.
Personal and shared views
- A personal view is yours alone. Nobody else sees it, admins included.
- A shared view is in every member’s sidebar. Only owners and admins can share, change or delete one; the audit log records each change. A member who edits a shared view’s filter can save the result as a new view of their own.
Swimlanes
Swimlanes split every column into rows, one a team or one a project, so you can see each team’s work side by side.
- Click Swimlanes in the board’s toolbar.
- Pick By team, or By project. By project needs one team picked in the sidebar first; its projects become the lanes.
- Optional: tick Show sub-teams as lanes to give each sub-team its own lane, or Hide empty lanes.
A card sits in its team’s lane, or in the lane of its nearest parent team that has one. Cards with no team (or no project) sit in a last lane of their own. Each lane’s header collapses it, and its More menu has Move up and Move down to reorder the lanes. Your swimlane choice and lane order are saved for you, and the phone’s board uses the same choice.
Tips
- A study has no menu entry of its own. Type
recipe:study, switch to the List layout grouped by status, and save it as a view to keep every study in one place. cycle:currentwithassignee:mesaved as a view gives you “my cards this cycle”.
