# 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

1. Press `F` on the board, or click the filter bar under the toolbar.
2. Type a token such as `label:bug`. The bar suggests keys first, then values. A finished token becomes a chip.
3. Add more tokens. Each key narrows the board further.
4. 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](https://andon-docs.pages.dev/guide/planning.md) |
| `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](https://andon-docs.pages.dev/guide/fields.md#filter-by-a-field) |
| `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. `J` and `K` (or the arrow keys) move, `Enter` opens a card, and `X` picks 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](https://andon-docs.pages.dev/guide/planning.md#the-timeline-layout).

## Save a view

1. Set the filter, the layout, and the grouping and sort if you use the list.
2. Press ⌘S (Ctrl+S), or click **Save view**.
3. Give it a **Name**. If you are an owner or admin, turn on **Share with the org** to share it.
4. 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.

1. Click **Swimlanes** in the board's toolbar.
2. Pick **By team**, or **By project**. By project needs one team picked in the sidebar first; its projects become the
   lanes.
3. 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:current` with `assignee:me` saved as a view gives you "my cards this cycle".
