Skip to content
Help articles

Lists

Lists are the columns of a board, like To do, Doing and Done.

Lists are the columns of a board. Use them for stages (To do, Doing, Done), for topics, or for days of the week.

Add and rename a list

At the right end of the board, choose Add another list (on a new board: Add the first list), type a title and choose Add list. To rename a list or give it a description, click its title.

The list menu

The ... button in a list's header opens its menu:

  • Star list (or Unstar list): a list you use often goes under Starred lists at the top of the board's left panel, and one click there scrolls the board to it. On a phone, your starred lists show under the board's title; tap one to swipe to it. Only you see your stars, so guests can star lists too.
  • Change color. A new list has no color. Pick one to tint the list and put a dot before its title, or choose No color to take it off.
  • Mark important (or Unmark important): its items then count as important. The board's Filter > Important shows them, and in For you its items with a due date carry the flag.
  • Move list to another board or Copy list to a board. A copy takes the items' titles, descriptions, checklists, labels and field values (on another board, of the fields it has too), but not their files or comments.
  • Select all items (or Unselect all items), to move, label or archive the items the list shows together.
  • New group...: a group of lists with this list in it. See Groups below.
  • Tidy up...: archive the items you no longer need. See Tidy up a list below.
  • Archive list.

Next to it, when you point at the header (or tap it on a tablet), are:

  • List type: what the list is for (Info, Capture, Backlog, To do, Doing, Ready for review, Done, or None). Agents use it to know where work goes. A Ready for review list is where agents put finished work, with a link to their pull request or document in a comment: you approve it by moving the item to Done, or send it back with a comment. Agents never take work from it. An item in a Done list counts as done: its due date shows as met everywhere (the board, the calendar and table views, a shared board and the calendar feed), and it never shows as overdue. Move it out of the Done list to open it again. The type shows small under the title when the title does not already say it.
  • Sort items by...: due date (soonest first, items without a date last), date added (newest or oldest first), title (A to Z) or important first. It sorts once and keeps no sort order: you can drag items afterwards, and new items still go where you put them. Choose Undo in the message that follows to put the old order back. The sort shows in the board's history as one change.

Drag a list by its header to put it somewhere else on the board.

Tidy up a list

Tidy up... in a list's ... menu archives many items in one go. Choose which ones:

  • Done items older than 2 weeks, 1 month or 3 months. An item is done when its due date is marked done, or when it is in a Done list.
  • Items not changed for 3 months or 6 months, done or not.

Older means nothing happened on the item since: no edits, comments, checklist ticks, labels or new files. Reordering the list does not count. Before anything happens, the window says how many items it will archive, for example "This archives 37 items". One click archives them. The message that follows has Undo. Items are archived, never deleted: they stay under View archived items in the board's ⋯ menu, and search still finds them.

Anyone who can edit the board can tidy up its lists: the owner, Edit guests and the team members who edit it.

Groups

A group is a named section of lists. Choose New group... in a list's ... menu to make one with that list in it. Or choose Add a group under the lists, next to Add another list. Then drag lists into the group, or out of it. Groups can be renamed, colored and folded shut, which helps on a board with many lists. Folding a group folds it for everyone on the board. On a phone, or on a board you can only view or comment on, folding a group changes your screen only. Deleting a group keeps its lists.

Archived lists

An archived list and its items are hidden, not deleted. Bring them back from the board's ⋯ menu with View archived lists. Only the board owner, and on a team board the team's owner and admins, can delete an archived list permanently there.

Lists for agents

Lists can also say what they are for: facts (Info), new things as they come up (Capture), backlog, to do, doing, ready for review or done. Set it with the List type button next to the list's ... menu. Agents use this to know where things go: they are asked to move work to a Doing list when they start it and to a Ready for review list (or a Done list) when it is finished. Below level 5 (Full), a move into a Done list waits in your Inbox. Boards made from the Project (for agents) template come with these lists set up.

Next: Board templates

Still stuck? Write to hello@listspace.app and a person will answer.