Manage columns on your board

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Managing columns on your board is essential for visualizing your team's workflow. Each column corresponds to a stage of work, such as "To do," "In progress," and "Done." You can customize these columns to match your specific process, while each card on the board represents a work item, such as a user story, bug, or task.

Note

Note

Prerequisites

Category Requirements
Access levels At least Basic access.
Permissions To configure team settings: Member of the Project Administrators security group or Team Administrator role. For more information, see Change project-level permissions.
Tasks (optional) To avoid revisiting your configuration, we recommend doing the following tasks before you begin to manage your board columns:
- Add custom work item types
- Customize your product and portfolio backlogs
- Customize workflow states
- Select backlog navigation levels for your team
- Show bugs on backlogs and boards

Add and edit columns

Column titles and options vary based on the process used to create your project and your team's decision to treat bugs as requirements or tasks.

Do the following steps to add and edit your columns:

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select Boards > Boards > Configure board settings .

    Screenshot shows selection sequence buttons, Boards, Boards, and Configure board settings.

  3. Select Columns.

    • To add a column, select + Add column.

    Screenshot shows highlighted Add column button.

    • To edit a column, select the column tab. For example, in the following image, we choose to edit the Active column.

    Screenshot that shows the Settings dialog and selection of an Active column.

  4. Do any of the following tasks for your columns. These tasks link to sections further in this article:

  5. Select Save.

Map workflow states to columns

Mapping workflow state categories to columns in boards is essential for visualizing the progress of work items. It ensures that each state of a work item is represented on the board, providing a clear and organized view of the workflow. This mapping helps teams quickly identify the current status of work items, track their progress, and spot any bottlenecks or issues. By aligning workflow states with board columns, teams can maintain a shared understanding of the workflow and improve their ability to manage and complete tasks efficiently.

Tip

We recommend that you map each workflow state to a column. If it’s not mapped, it doesn’t appear on the board.

The following table describes default user story state categories.

State category Description
Proposed The first board column is automatically mapped to the default state for each work item.
In Progress Work flow state must be specified for each work item type and column.
Completed Can only map to the last board column.
Removed Workflow state doesn't need to be specified.

For more information, see About workflow and state categories.

Screenshot shows State mapping section of Column Edit page.

Do this task whenever you add columns, workflow states, or work item types (WITs). This action is typically necessary when you change the Working with bugs setting, add WITs to the Requirement category, or customize the workflow.

Note

When you add bugs or other work items to a board, it might create new workflow states that require adjustments to column-to-state mappings in the following situations:

Rename a column

Renaming your column titles to map to your workflow stages helps ensure clarity and alignment within your team. It allows everyone to understand the current status of work items at a glance and ensures that the board accurately reflects your team's workflow.

Rename a column directly from the board by selecting the column name, shown in the following image. You can also rename a column from the column edit screen.

Screenshot showing renaming a column directly on a board.

Split columns

Each column represents a work stage, showing the number of items in progress. But, there’s often a lag between moving work into a column and starting it. To address this lag, enable split columns, which divide each column into "Doing" and "Done."

Screenshot showing with split columns.

Split columns help your team implement a pull mechanism, providing visibility into idle items and improving workflow transparency.

Note

Choose the column tab that you want to split and add a check mark in the box to cause the column to split.

Screenshot of board settings page, Split columns.

Tip

You can filter queries and create charts using the Board Column Done field.

Move items into the Doing and Done columns

With split columns enabled, update item statuses as usual. When you complete work on an item, move it to Done instead of a downstream column. The next team member pulls it into Doing and reassigns it to themselves when ready.

For example, after finishing a coding task, move it to Done under Develop. The tester then pulls it into Doing under Test when ready to start testing.

Screenshot showing board with split column.

Identify bottlenecks

Split columns provide greater insight into how many items sit idle in a Done column. Your team can easily see when items pile up, signaling a potential bottleneck.

Review the frequency and location of pile-ups, so your team can adjust processes to eliminate bottlenecks. Workflow processes with no or few bottlenecks correspond to perfect flows.

Screenshot of board, split columns showing stacked items.

List work items in a Doing or Done column

You can query for work items in a split column using the Board Column Done field. This field takes of a value of False when in the Doing column and True when in the Done column.

For examples on querying Board columns, see Query by assignment or workflow changes.

Add Definition of Done to a column

When your team advances from one stage to the next, it's crucial they share a clear understanding of "Done." Define the criteria for the Definition of Done in each column. This action helps the team identify necessary tasks before advancing an item to the next stage, implementing the core tenet of making processes and policies explicit.

Choose a column tab to configure the Definition of Done for that column.

Screenshot showing the columns management screen, entering plain text for Definition of Done.

Users can quickly double-check the criteria by choosing the Information tooltip info icon.

Screenshot showing information tooltip of Definition of Done.

Remove or move a column

Removing or moving a column can help streamline your board and better reflect your team's workflow and priorities. By adjusting the order of columns or removing unnecessary stages, you can ensure that the most critical stages are prominently displayed and that the workflow is intuitive for all team members.

Remove a column

  1. Ensure the column doesn't contain any work items. If it does, move the items to another column.

  2. On the Configure board settings page, select Columns > Column options menu > X Remove.

    Screenshot that shows the selections for deleting a column in the Settings dialog.

Move a column

To move a column, drag the column tab to the desired position on the board or in the Column options menu, select Move left or Move right.

Screenshot shows the column options menu in Configure board settings.

Update status

To update status, drag-and-drop your work items. For example, to signal when work can start in a downstream stage, drag items to the next column. You can move an item from one column to any other column on the board, forward and back.

Screenshot that shows dragging an item from the Analyze column to the Develop column.

Hand off work items

To hand off work to another team member, reassign it directly from the board.

Screenshot that shows assigning an item from a board.

Users who receive the handoff can set alerts to get immediate email notifications of their newly assigned work.

Track column status

Use the query tool to list a subset of work items for review, triage, update, or chart generation. For example, you can create a query to list all active user stories (specify two clauses: Work Item Type=User Story and State=Active).

Specify work in progress (WIP) limits, split columns, and definition of done.

Change your team's priorities

Drag an item up or down within a column.

Screenshot that shows moving an item within a column.

Do more tasks

In the following table, we list tasks and their associated articles, so you can do more with your board.

Article Task
Interactively filter backlogs, boards, queries, and plans Filter your board to focus on select work based on assignment to a team member or sprint, tags, or parent feature.
Update status Update workflow status through drag-and-drop operations.
Change priorities Reorder cards to change priority of work items.
Customize cards View and quickly assign values to key field.
Track board column status Create queries and charts based on board columns.
View and configure a cumulative flow diagram Review a cumulative flow diagram based on column assignments.