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
- To manage columns on a sprint Taskboard, see Customize a Taskboard.
- To manage columns on a backlog or in query results, see Change column options.
- To view frequently asked questions about Azure Boards, see FAQs.
Note
- To add columns to a Taskboard, customize the workflow. For more information, see Add or modify a work item type.
- To add columns to a backlog or query results, see Change column options.
- To see an overview of the features supported on each backlog and board, see Backlog, board, and plan views.
- To view frequently asked questions about Azure Boards, see FAQs.
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:
Sign in to your organization (
https://dev.azure.com/{yourorganization}
).Select Boards > Boards > Configure board settings .
Select Columns.
- To add a column, select + Add column.
- To edit a column, select the column tab. For example, in the following image, we choose to edit the Active column.
Do any of the following tasks for your columns. These tasks link to sections further in this article:
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.
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:
- When a team administrator shows bugs on backlogs and boards.
- When a project administrator adds work item types to backlogs and boards.
- When a project collection or project administrator customizes the workflow for a work item type in the Requirement category using inherited process or on-premises XML process.
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.
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."
Split columns help your team implement a pull mechanism, providing visibility into idle items and improving workflow transparency.
Note
- Before you split columns, ensure that each stage is mapped to a column. Only split columns where clear hand-offs exist and you want teams to pull the item into the next stage.
- There are different column titles and choices based on the process used to create your project and whether your team chose to treat bugs like requirements or like tasks.
Choose the column tab that you want to split and add a check mark in the box to cause the column to split.
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.
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.
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.
Users can quickly double-check the criteria by choosing the Information tooltip info icon.
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
Ensure the column doesn't contain any work items. If it does, move the items to another column.
On the Configure board settings page, select Columns > Column options menu > X Remove.
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.
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.
Hand off work items
To hand off work to another team member, reassign it directly from the 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.
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. |