Cards and lists¶
Adding and editing cards¶
Click Add a card at the bottom (or top, depending on your
insertion setting) of a list, or click a
card to edit it in place. By default, Enter finishes a card and Shift+Enter adds a new line
— this can be swapped in New line trigger.
Turn on a checkbox next to each card's title with
Display card checkbox; Ctrl/Cmd-clicking it
archives the card.
Quick actions¶
Hover a card to show its quick action panel in the top-right corner: by default Mark as
done, Add or change date, Move to next list and ⋮, which opens the card menu (as
does a right-click). Choose the buttons in Quick actions.
Card size¶
Set a card's size from its menu (Size), or click the size in the card footer to change it:
XS, S, M, L or XL. Each list shows the total of its sizes next to the card
count; hover it, or click it, to see how it adds up. The size is a tag in the card text
(#size/M); see Card size. To set sizes in one click, add Set
size to the quick actions.
Card relations¶
Link two cards of the same board: right-click a card → Add relation, pick the kind of relation, then pick the other card. The kinds read from both sides:
| On this card | On the other card |
|---|---|
| Blocks | Blocked by |
| Relates to | Relates to |
| Duplicates | Duplicated by |
| Causes | Caused by |
| Depends on | Required for |
A card blocked by a card that is not done yet shows a red Blocked mark above its text and a dashed checkbox; once the blocking card is done or archived, the mark goes away. It is only a signal: a blocked card can still be moved and checked.
The footer shows how many relations a card has. Click the number (or Blocked) to see them:
click a card there to scroll the board to it, × to remove the relation, Add relation to add
another. Relations to archived cards stay in the list, marked in archive. Deleting a card
removes its relations; a duplicated card has none.
Relations are kept in a hidden block at the end of the board file, so the card text does not change. See Card relations to switch them off, and add Add relation to the quick actions to relate cards in one click.
Embedding images¶
Images can be embedded in a card just like in any other Obsidian note:

A card can also display an image pulled from a linked note's metadata — see Linked page metadata.
Creating a note from a card¶
Right-click a card, or open its ⋮ menu (in the quick action panel), and
choose New note from card.

This creates a note in the note folder using the note template, titled after the card's text. The card then links to the new note.

List descriptions¶
A list can have a short description under its title — what belongs in it, who works on it, a link to a related note. It is shown in a smaller, muted font so it does not draw attention away from the cards. Lists without a description look as before.
- To add one, open the list menu (⋮) and choose Add description, or fill in the optional Description field when creating a list.
- To change it, double-click the description (or use Edit description in the list menu). As with cards, Enter saves and Shift+Enter adds a new line (see New line trigger); Esc cancels and clicking elsewhere saves. Clear the text to remove the description.
The description may span several lines and use markdown: links, [[wikilinks]], bold and
italic. In the board file it is the text right under the list's heading:
## In progress (3)
Work for this week. See [[Roadmap]].
- [ ] A card
WIP limits¶
To cap how many cards a list can hold, put the limit in parentheses after the list's title —
for example, rename In progress to In progress (5). The limit shows next to the list's
card count:

Once the list has more cards than the limit, the count is shown in bold:

Rename the list again with a new number (or without one) to change or remove the limit.
Searching a board¶
Search a board like any other note — the default hotkey is Ctrl/Cmd + F.

Whether clicking a tag searches the board or the whole vault is controlled by Tag click action.
Filtering by tags and boards¶
The funnel button in the board header opens a filter row under it:
- Tags. Click the field to see every tag on the board with the number of its cards, or
type to narrow the list. Pick as many as you like: the board shows cards that have any
of the selected tags. Picking
#workalso shows#work/urgent; case does not matter. - Boards. On a board with linked lists, a second field picks the boards whose cards to show (This board is the board you are looking at).
Selected tags and boards appear as chips; click × on a chip to remove it, or press Backspace in an empty field. Lists without matching cards collapse while the filter is on, and the filter works together with the text search. As with search, Add a card is hidden while the filter is on — a new card without the selected tags would disappear at once.
Click the funnel again (or × at the end of the row) to close the row and reset the filter. The filter is never saved to the board file and resets when the tab is closed. On phones, where the header buttons are hidden, use the command Filter cards by tag.
The button can be hidden in Board header buttons.