Manage columns on your Kanban board

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

The Kanban board helps you visualize your team's workflow, including the types of work and handoffs that occur regularly as your team progresses work items. Each column on your Kanban board corresponds to work that your team does before that stage is considered done.

Note

Note

Prerequisites

  • To configure team settings, you must be added to the Team Administrator role or be a member of the Project Administrators security group. To get added, see Add a team administrator or Change project-level permissions.
  • You must be assigned Basic access or higher to exercise all backlog and board features. Users with Stakeholder access can only edit work items on the board and add existing tags to a work item. Stakeholders can't add work items or update fields displayed on cards. For more information, see About access levels.
  • To configure team settings, you must be added to the Team Administrator role or be a member of the Project Administrators security group. To get added, see Add a team administrator or Change project-level permissions.
  • You must be assigned Basic access or higher to exercise all backlog and board features. Users with Stakeholder access can only edit work items on the board and add existing tags to a work item. Stakeholders can't do the following tasks. For more information, see About access levels.
    • Add work items to a board
    • Drag-and-drop work items to update status or reorder cards
    • Update fields displayed on cards

Complete the following tasks, so you don't need to revisit your configuration.

  • Add custom work item types that you want to appear on your backlog or board. For more information, see Add and manage work item types.
  • Customize your product and portfolio backlogs. Customization ensures that the chosen work item types appear on the backlogs and boards. For more information, see Customize backlogs and boards.
  • Customize workflow states. Each workflow state appears as a column on the Kanban board. For more information, see Customize a workflow.

We recommend that you review the following articles:

Map workflow states

The Kanban board uses the Work item type and State categories to group work items that you want handled in the same manner.

  1. Identify your team's workflows. See the following table of example workflows and their descriptions.

    Workflow Description
    Backlog Make a prioritized list of work items that the team isn't yet ready to work on
    Analyze Identify well-understood and shared acceptance criteria, along with overall work required to develop and test the item
    Develop Code and run unit tests for the item
    Test Run exploratory, automated, integration, and other tests
    Done Hand off to production because the item is ready
  2. Know your work item types and on which boards they appear.

    Work item type category Work items appear here
    Requirement Only on the product board
    Feature Only on the Feature portfolio board
    Epic Only on the Epic portfolio board
    Custom Only on a custom portfolio board

    Tip

    We recommend that you map each workflow state to a Kanban column, as if it's not mapped, it doesn't appear on the Kanban board.

  3. Specify the workflow State for each work item type and column, using one of the following four categories.

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

Note

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

Add and edit columns

Column titles and choices depend on the process that you used to create your project and whether your team chose to treat bugs like requirements or like tasks.

Do the following steps to add and edit your columns.

  1. Open your Kanban board.

  2. Select Configure team settings to configure the board and set general team settings.

    Screenshot that shows open board settings for a team.

  3. Select Columns and then a column tab to see all the settings that you can modify. Your initial column settings look similar to the settings shown in the following image.

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

  4. Change your column titles to map to your workflow stages. You can add, rename, and move columns to support more stages.

    Rename the first three columns to Backlog, Analyze, and Develop. Then, add a column and label it Test.

    You can rename a column directly from the Kanban board.

    Screenshot showing renaming a column directly on a board.

    Or, you can open the dialog and change one or more settings for a Kanban column.

    Screenshot that shows the Settings dialog and selections for adding a Test column.

  5. To change the column order, drag the column tab to the position that you want.

  6. To delete a column, first make sure that the column doesn't contain any work items. If it does, move the items to another column. Then:

    1. Open Settings, select Columns, and select Actions from the column tab.
    2. Select Remove from the menu.

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

  7. Change state mappings as needed for added columns, added workflow states, or added WITs.

    Usually, you need to update state mappings when you change the Working with bugs setting, add WITs to the Requirement category, or customize the workflow.

  8. When you're done with your changes, select Save.

Update status and handoff items

Drag-and-drop your work items to update the status. For example, to signal when work can start in a downstream stage, drag items to the next column.

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

You can move an item from one column to any other column on the board, forward and back. To hand off work to another team member, reassign it directly from the board.

Screenshot that shows assigning an item from a Kanban board.

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

Change your team's priorities

Drag an item up or down within a column. Screenshot that shows moving an item within a column.

Track Kanban 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 WIP limits, split columns, and definition of done

Split columns

Because each column corresponds to a stage of work, you can quickly see the number of items in progress at each stage. However, a lag often exists between when work gets moved into a column and when work actually starts. To counter that lag and reveal the actual state of work in progress, you can turn on split columns. When they're split, each column contains two subcolumns, Doing and Done.

Screenshot showing Kanban with split columns.

Split columns let your team implement a pull mechanism within the workflow process. Without split columns, teams push work forward, to signal that they completed their stage of work. However, pushing it to the next stage doesn't necessarily mean that a team member immediately starts work on that item.

With split columns, your team knows exactly how many items sit idle, waiting for work to begin. You have greater visibility into the quantity of items that sit idle at each stage throughout your workflow process.

Move items into the Doing and Done columns

With split columns turned on, you update status of items on the Kanban board in the same way you have before. However, now when you complete work on an item, you move it into Done, instead of a downstream column. When the next team member becomes free to work on the next high priority item, they pull it into Doing and reassign it to themselves.

For example, as a team member completes their coding task, they move the item into Done under the Develop column. When the tester is ready to test the item, they pull it into Doing under the Test column.

Screenshot showing Kanban board with split column.

Identify bottlenecks

Split columns provide you even greater insight into how many items sit idle in a Done column. Your team can readily see when items pile up, which signal a potential bottleneck.

Screenshot of Kanban board, split columns showing stacked items.

By reviewing the frequency of pile ups and where they occur, your team can adjust their processes to eliminate the bottlenecks. Workflow processes that incur no or few bottlenecks correspond to perfect flows. No item sits in a queue for any

Choose which columns you want to split

Before you split columns, ensure you mapped each stage of your team's process to a Kanban column. Only split columns where clear hand-offs exist and you want teams to pull the item into the next stage.

  1. Open your Kanban board and choose the gear icon to configure the board and set general team settings.

    Screenshot of Open board settings for a team, vertical navigation.

  2. Choose Columns and then choose the column tab that you want to split. Add a check mark in the checkbox to cause the column to split.

    Note

    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.

    Screenshot of Kanban board settings page, Split columns.

  3. When you're done, choose Save.

    Tip

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

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 the Definition of Done to a column

When your team advances from one stage to the next in their work, it's crucial that they have a shared understanding of what constitutes as "done." You can define the criteria for the Definition of Done in each Kanban column. By doing so, the team can identify the necessary tasks that need to be completed before advancing an item to the next stage. This task also implements one of the core Kanban tenets, make processes and policies explicit.

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

Screenshot showing information tooltip of Definition of Done.

  1. Open your Kanban board.

  2. Choose the gear icon to configure the board and set general team settings.

    Screenshot of the settings gear highlighted for selection.

  3. Choose Columns and then 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.

  4. When you're done with your changes, select Save.

Do more tasks

In the following table, we list tasks and their associated articles, so you can do more with your Kanban 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.