Skip to content

The workspace board

Every workspace as a card, in the column that says what is happening to it, with card, calendar and per-person views.

Where
WorkspacesIn the app (sign-in required), opens in a new tab.
Reading time
2 min read

How it works

The board is the front page. Columns are your organization's own board stages (Settings → Board stages), not a fixed set, and dragging a card between them is how a workspace's state changes.

Three views over the same workspaces:

  • Board, the kanban. Group by Stage (where each workspace is) or by Task Status (what its tasks are doing), and filter to one person with the people row.
  • Cards, a denser list, for when you want detail rather than position.
  • Calendar, workspaces against their deadlines.

The active column carries a rule beyond its label: only workspaces in it may keep a container running. A workspace sitting in Backlog or Completed is, by the board's own account, not being worked on, and a container for work nobody is doing is the biggest single source of idle memory. The column your organization marks as default is that statement, so there is no second setting to keep in step.

Which workspaces you see depends on your role. Owners and maintainers see every workspace in the organization; members see the ones they are assigned to plus any they created. A maintainer who does not want all of them on their board can hide some, that choice is per-person and per-device, and cannot widen what anyone can reach.

Steps

Following along? Tick each number off as you go.

  1. Open Workspaces.

  2. Switch between Board, Cards and Calendar with the view buttons.

  3. Use By Stage / By Task Status to change what the columns mean.

  4. The board opens on your own workspaces. Pick another person above the board to see theirs.

    Everyone shows the whole organization, and Mine brings you back. If you are on no workspaces, it opens on everyone.

  5. Drag a card into another column to move the workspace.

    Moving it out of the active column stops its box; moving it back starts it again.

  6. Use Search workspaces to find one by name.

    Faster than scanning, and it is what you want on a board of a few hundred cards.

  7. Press Archived to see workspaces that have been taken off the board.

Worth knowing

  • Renaming your active column is fine, the running rule follows the column your organization marks as default, not the word "In progress".

  • Moving a workspace out of the active column stops its box straight away. Opening it starts it again; nothing on the volume is lost.

Read next

Getting startedCreating a workspaceThe New workspace wizard asks four questions: what it is, which repositories, how its branches reach production, and where each branch runs.Running the organizationOrganization settingsThe defaults every workspace inherits: what its container is built with, the board's columns, the git flow, the agent and accounts boxes run on, and the standing instructions every agent reads.Getting startedTasksThe work inside a workspace: what was asked for, what state it is in, and a note timeline saying how each piece was done.
Report a problem