Laver docs
Open Laver
Boards and tickets

Filters and card display#

A busy board is easier to read once it is filtered, and once its cards show only the things you actually look at. Both controls live in the board header.

Filtering changes nothing for anyone else. Card display is saved per person as well — see Whose settings these are.

Filter tickets#

Type into the Filter tasks... box in the board header, or press / from anywhere on the board to jump into it.

  • It matches the ticket title and description, ignoring case. It does not search comments, labels or assignees.
  • Pasting a ticket uuid finds that ticket. A prefix is enough, so the first block is plenty — useful when someone sends you a uuid from a link or an API response rather than a link you can click.
  • It filters live as you type, across every column at once. Column counts stay as they are; the "N tasks shown" summary under the header follows the filter.
  • The cross at the right of the box clears it.
  • It only ever looks at this board. To find something on a board you are not looking at, press Cmd/Ctrl+K — see Search the workspace.

The API searches the same two fields: GET /boards/{board_uuid}/tasks?q=... matches titles and descriptions. It matches them differently, though — the box above is a substring filter over the tickets already on screen, while the API runs a full-text search over the whole board and ranks what it finds. Whole words there, so xport finds nothing; expor still finds export. See Tickets by API.

Filter by what tickets carry#

Filters in the board header opens a panel of the attributes tickets already have. The button carries a count while any of them is on.

Filter Notes
Label Tick any number
Priority Tick any number. No priority is a choice like the rest, not "any"
Assignee One person, or Unassigned for tickets with nobody on them
Created by One person — who filed the ticket, rather than who is working on it
Due date A From date, a To date, or both. Both ends are inclusive
Overdue only Due before today and not in a completing column
Breakdown Has subtasks, Has sub-tickets, or both

Created by and Assignee are separate questions, and using both narrows: Created by Sam plus Assignee Ash means the tickets Sam filed that Ash is working on. Some tickets are filed by nobody at all — what a feedback form submits, and the copies a repeating ticket makes — and No creator (forms, repeats) is how you pick those out.

Breakdown finds the tickets somebody has already split up, and a ticket can be split up in two ways — so it is two boxes:

  • Has subtasks — the ticket has at least one item in its Success Criteria checklist, whether or not any of them are ticked off. This is the done/total badge the cards carry.
  • Has sub-tickets — the ticket has been broken into tickets of its own, and is the card those pieces are folded into. Pieces on another board are not counted, because they are not inside the card you are looking at.

They are separate filters and narrow each other: ticking both shows only the tickets carrying a checklist and holding sub-tickets. While either is on, the pieces come back out of their parents' cards like they do under any other filter — a piece with a checklist of its own is a ticket with subtasks and is found as one.

Two rules worth knowing:

  • Ticking two things inside one filter widens it. Two labels means either label, not both — asking for both would usually return nothing.
  • Separate filters narrow. Priority High plus Overdue only shows tickets where both are true.

A ticket with no due date is outside every due-date range and is never overdue, so it disappears when you filter by either.

Clear all filters at the foot of the panel resets everything at once, including the search box and Assigned to me. The "N tasks shown" summary offers the same shortcut while anything is on.

Show only your tickets#

Assigned to me in the filter row toggles the board down to tickets you are an assignee on. It combines with everything above and with the group tabs.

Reordering while filtered#

While anything is hiding tickets — the search box, Assigned to me, or any filter in the panel — reordering within a column is switched off. The column in front of you is not the whole column, so a drop between two visible cards would put the ticket somewhere you did not intend. Moving a ticket between columns still works, and adds it to the end of the destination column. The header says so while a filter is active.

Filter by group#

If the board has groups, the filter row shows an All tab plus one tab per group, each with a count. Click one to show only that group's tickets. The choice is kept in the page URL, so the filtered view is shareable.

Two things to know about groups:

  • Create one from the filter row itself — the Add group tab at the end of the row. You can reorder group tabs by dragging them, and remove one with the cross on the tab; removing a group does not delete its tickets — they stay on the board and fall back to All.
  • A ticket is put into a group from the ticket itself. Open it and use the Group picker at the bottom of the rail; New group there creates a group on the board and puts the ticket in it in one step, so a group you thought of while reading a ticket does not send you back to this row. There is no drag-to-tab. See Tickets.

There is no filter for status: status is what the columns already are.

Choose what cards show#

Click Card display in the board header. Under Show on cards:

Preference Default Shows
Priority On The priority flag, on tickets that have a priority
Assignees On Avatars of the people assigned, up to two
Due date On The date, highlighted when overdue
Cover image Off The ticket's oldest image attachment, across the top of the card

Priority shows nothing on a ticket that has none. "No priority" is the default on every new ticket, so a chip saying so would be on most of the board saying nothing; switching the preference off hides the flag everywhere, including on the tickets that do have one.

Some things are always on the card and cannot be turned off: the title, its labels (up to three, then a +n), its column's name, the success-criteria badge when the ticket has any, and the ticket actions button.

Labels, priority and the column name share one row above the title, in that order. They stay on one row for as long as the card is wide enough for them — which depends on how many columns the board has, whether the split view is open, and how wide the window is — and wrap onto a second when it is not. The labels are what wraps: priority and the column name stay together, and a label too long for the row is shortened with a rather than being allowed to push them off it.

Cover image has no picker: the card uses the oldest image attachment on the ticket. To change it, delete that attachment; the next-oldest image takes over.

Hover shortcuts#

Under Hover shortcuts (up to 4) in the same menu, tick up to four of the board's columns. Those columns become buttons that appear on a card when you hover it, each moving the ticket straight into that column — useful for a two-click triage pass without opening anything.

With none ticked you still get a single shortcut to the board's completion column, labelled Mark as completed. Ticking a fifth column is blocked until you untick one.

A ticket moved by a hover shortcut lands at the bottom of its new column.

Whose settings these are#

Card display preferences — the four toggles and the hover shortcuts — are saved per person, per board. Changing them affects only your view of that one board, and you can have different settings on every board you work on.

Filters are not saved at all. The search box, Assigned to me and everything in the Filters panel reset when you leave the board; the group tab lives in the URL, so it survives a reload and can be shared.