Board statuses and what they mean

Every board has its own list of statuses — you name them, color them, and choose which one new rows start in. When a source is connected, its native statuses map onto this list.

deckgauge · Manage Statuses
Not Starteddefault
In Progress
At Risk
Blocked
Done

A board's status list — label, color dot, and default marker.

What it does, and where the data comes from

A new board seeds five default statuses — Not Started, In Progress, At Risk, Blocked, and Done — with Not Started marked as the default. These aren't fixed: rename any of them, recolor them from a 50-color palette (a color already in use elsewhere on the board is disabled so pills stay distinguishable), or delete the ones you don't need. This list is what draws the colored status pill on each row, and it's what Automations match against for both the "status changes to…" trigger and the "Change status" action.

How to manage statuses

  1. Open Manage Statuses — from the board's status controls.
  2. Add a status — type a name and confirm; it's appended to the end of the list.
  3. Rename — click a status label to edit it in place; Enter saves, Escape cancels.
  4. Recolor — click the color dot to open the palette; colors already used by another status on this board are greyed out.
  5. Set the default — mark one status as default; it's what new and reassigned rows fall back to.
  6. Delete — confirms first. Rows on the deleted status are reassigned to the board's default status (or the next remaining one), so nothing is left dangling.

How board statuses relate to source statuses

Jira, GitHub, and Azure DevOps each have their own native status vocabulary — Jira's issue status, GitHub's labels plus open/closed state, ADO's work-item state. Deckgauge doesn't invent a mapping for you: from a source's card on the Sources tab, open its status-mapping editor and pair each native value with one of this board's statuses. Until a native value is mapped, it falls back to whatever default behaviour the sync uses.

If it looks wrong

SymptomCauseFix
Can't pick a color for a new statusEvery palette color is already used on this boardRecolor or delete an existing status to free one up
Deleting a status seems to "lose" rowsIt doesn't — deleted rows reassign to the default statusCheck the default status for rows that were on the deleted one
"Edit mapping" is disabled on a source cardThe board has no statuses configured yetAdd at least one status in Manage Statuses first
The item panel's Status field only offers 5 fixed values, not your custom onesThe item detail panel and the bulk "Change status" action currently use the fixed Not Started/In Progress/At Risk/Blocked/Done set, separately from your Manage Statuses listSet a custom status from the row's own status pill on the board grid instead

Related

Last updated