# Custom Backlog Columns

> Adds your own columns to a project's backlog board, next to the built-in TODO, Development, Pending, In Review and Done: a "QA", "Blocked" or "To validate" stage, with its name, its color, its icon and its place on the board.

- Area: Desktop, mobile and web
- Plans: All plans
- Last checked against the product: 2026-11-16
- Web page: https://agentsroom.dev/docs/backlog-custom-columns

## What it does

Adds your own columns to a project's backlog board, next to the built-in TODO, Development, Pending, In Review and Done: a "QA", "Blocked" or "To validate" stage, with its name, its color, its icon and its place on the board. By default a custom column has no automation: a ticket in it simply waits there until you move it. Give it a **Column prompt** (see [Backlog Column Prompts](https://agentsroom.dev/docs/backlog-column-prompts.md)) and dropping a ticket there runs that prompt, with the running agent or a new one. The columns belong to the board, so every computer and the phone see them.

## Where to find it

- Desktop, inside a project's **Backlog**: the dashed **Add column** tile at the right end of the board.
- The **...** button in a column's header (**Column options**), built-in columns included.

## How to use it

1. Click **Add column**. In **New column**, type a **Name** (40 characters max), pick a **Color** (the same picker as account colors: a palette, or any color with the color wheel or a hex code; a new column gets a color no other column of the board uses) pick an **Icon** (a grid of workflow icons drawn in the column's color: spec, test, bug, review, release...; the first one, the dashed circle, is the default) and choose **Place after** (the column it follows; by default the one before Done). Click **Create column**.
2. Drag tickets into it and out of it like any other column, and reorder them inside it.
3. **Column options** (the **...** of its header): **Edit name, color or icon**, **Move left**, **Move right**, **Delete column**.

Deleting a column sends its tickets back to the top of TODO: no ticket is ever deleted. The icon shows in the column header, on its folded rail, in the **Move ticket to…** menu, in the **Move** menu of the selection bar (in the column's color) and next to the column name on the all-projects board. A custom column can be folded into a narrow rail like the others. In an agent's console, when the next column of the board after the ticket's column is a custom one (Pending is skipped, In Review counts only for a ticket with a reviewer), the green button shows that column's name and icon: a click moves the ticket there and runs its column prompt, exactly like a drag on the board. The same goes for **Development** when the ticket sits in a custom column placed before it (for example a "Specification" column between TODO and Development): the button shows Development instead of **Send to review**, and a ticket assigned to a team starts its team run there, as when you drag it onto Development. **Done** (or **Send to review**) stays next to it as an icon. A custom column whose **Offer as next step** is off is skipped like Pending: the console looks at the columns after it, and shows **Done** when none is left. On a board without custom columns the console does not change. When Development is empty it shows a short animation of a ticket turning into an agent, with "Drop a ticket here": without a column prompt, it is the one column that starts one.

**Built-in columns**: TODO, Development, Pending, In Review and Done can be personalized too, board by board: **Column options** > **Edit name, color or icon** opens the same dialog, without **Place after**. **Restore defaults**, shown once something was changed, brings back the translated name, the theme color and the original icon.

Only their look changes. The status stays the same for tickets, agents and tools: a renamed Development still starts agents and its icon keeps pulsing, a renamed Done still closes tickets. A field you leave alone keeps following the app language (or the theme). The new look shows on the board and the folded rail, in **Move ticket to…**, the selection bar, the command palette, the subtasks and on the phone. The all-projects board keeps the default names and colors, since one lane there groups several boards. A board template neither saves nor applies this look, and a public backlog keeps showing its own statuses to reporters.

## Settings

- **Offer as next step** (`offerAsNext`, per custom column, stored with the column on the server): **Column options** > **Edit name, color or icon** (or **New column**), the switch under **Icon**. On by default, which is how every column behaved before. Off: an agent's console never offers this column as the ticket's next step and skips it, like Pending, for example to get **Done** after Development on a board whose next column is an "Auto - pending" parking lane. The column stays a normal column on the board and in **Move ticket to…**. MCP: `backlog_column_save({ key, offerAsNext: false })`, read in `backlog_columns_list`. Not on built-in columns.

`backlogCollapsedColumns` (see [Backlog Task Board](https://agentsroom.dev/docs/backlog-task-board.md)) also remembers folded custom columns.

## Agent tools (MCP)

- `backlog_list`: returns the board's `columns` (`key`, `label`, `position`) when it has some; the `"open"` filter includes tickets in custom columns.
- `backlog_create`, `backlog_update`, `backlog_reorder`: a ticket's `status` can be a custom column key (`col_...`). A key the board does not define is refused.
- `backlog_columns_list`: every lane of the board, left to right, built-in and custom, with its name, color, icon, place, prompt, mode and agent.
- `backlog_column_save`: without `key`, creates a custom column; with `key`, changes only the fields passed: `label`, `color`, `icon`, `offerAsNext` (custom column only, see Settings), and `after` (a lane key, or `"start"`) to move it. A built-in lane also takes `label`, `color` and `icon` (`""` puts a field back to the app's default) but keeps its place; `backlog_columns_list` adds `defaultLabel` on a renamed one and `backlog_list` lists renamed built-in lanes in `columns` too.
- `backlog_column_delete`: deletes a custom column on an explicit instruction naming it; its tickets go to the top of TODO. `board: "team"` addresses the team board on all three.

## Providers

All providers, no difference. A custom column only starts an agent when it has a column prompt ([Backlog Column Prompts](https://agentsroom.dev/docs/backlog-column-prompts.md)).

## Mobile

Custom columns show up as tabs of the board, in the same order as on the desktop (the tab row scrolls sideways past five tabs), and the ticket detail offers them as move destinations. A column with an icon shows it on its tab, in the ticket's status badge and on the rows of the **Backlog** tab; a column without one looks as before. The **Move** sheet of the selection bar lists every column with its icon and color, like the desktop menu. The name, color and icon given to a built-in column show there too. Creating, renaming, recoloring, choosing the icon, moving and deleting a column is done on the desktop. The phone's **Backlog** tab (all projects) groups them in one **Custom columns** tab. A change made by an agent reaches the board on screen without reloading when the phone is paired to the computer that agent runs on; otherwise the board catches up when you come back to it or pull to refresh.

## Limits

- 12 custom columns per board. Not on the idea box.
- Built-in columns cannot be deleted or moved.
- A ticket moved to another project's board lands in TODO there (its column belongs to the old board).
- A ticket in a custom column counts as open work: it still holds the tickets it blocks, and **Start next** only ever takes from TODO.
- On a public backlog, a ticket in a custom column shows the same status as TODO to its reporter, until you announce its fix (the column name is never shown). Once announced, the reporter reads it as done, is told when the release ships and can answer the retest question, even if you only move the ticket to Done later. Moving it back to TODO cancels the announcement.

## Common questions

- **Can I add my own column to the backlog?** Yes: click the dashed **Add column** tile at the right end of the board, give it a name and a color and pick where it goes.
- **Does a custom column start an agent?** Not by itself: moving a ticket out of Development into a plain custom column leaves its agent running. Give the column a **Column prompt** (**Column options** > **Column prompt**) to have it run its own instructions.
- **What happens to the tickets when I delete a custom column?** They go back to the top of TODO. No ticket is deleted.
- **Can I rename TODO or Done?** Yes, since 2026-11-04: **Column options** > **Edit name, color or icon**, board by board. **Restore defaults** brings the original back.
- **If I rename Development, does it still start agents?** Yes. Renaming, recoloring or changing the icon of a built-in column only changes how it looks: it keeps doing the same thing, and its icon keeps pulsing.
- **Does a new name apply to all my projects?** No, to this board only, like a custom column.
- **How do I delete a column?** Open the **...** of its header and choose **Delete column**. A folded column shows no **...**: click it to unfold it first. Its tickets go back to the top of TODO.
- **Can I move or delete a built-in column?** No. They keep their place on the board and always exist, because what they do depends on them. Their **...** menu shows **Delete column** greyed out, with the reason: they can be renamed, not deleted.
- **Why does my agent's console show my QA column instead of Done?** Because QA is the next column of your board after the ticket's column. The green button moves the ticket there and runs QA's column prompt, like a drag. **Done** or **Send to review** is still there, as the icon right next to it, and **Move ticket to…** lists every column.
- **Can I keep Done as the console's main button after Development, even with a custom column next?** Yes: open that column's **Column options** > **Edit name, color or icon** and turn off **Offer as next step**. The console skips it (and any other column switched off) and shows **Done** when no offered column is left.
- **Can I give a column its own icon?** Yes, any column: **Column options** > **Edit name, color or icon**, then pick one in the **Icon** grid. On a built-in column, the first tile of the grid is its original icon. Only the icons of that grid are offered, no emoji or uploaded image.

## Related

- [Backlog Task Board](https://agentsroom.dev/docs/backlog-task-board.md)
- [All Backlogs](https://agentsroom.dev/docs/global-backlog.md)
- [Backlog Column Prompts](https://agentsroom.dev/docs/backlog-column-prompts.md): give a column its own prompt and agent.
