Show bugs on backlogs and boards

Azure Boards | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

As your team identifies code defects or bugs, they can add them to the backlog and track them similar to requirements. Or, they can schedule them to be fixed within a sprint along with other tasks.

When you track bugs as requirements, they'll show up on the product backlog and Kanban board. When you track bugs similar to tasks, they'll show up on the sprint backlogs and task boards. If you want to track additional work item types (WITs) or custom WITs on your backlogs or boards, you can. See Add other work item types to backlogs or boards later in this topic.

Set your team's preferences for tracking bugs

You can change the setting from a backlog or board view. Here we show how to change it from the board view.

In the Working with bugs dialog, you can select from the following three options.

  • Choose the first option when your team wants to manage bugs similar to requirements. Bugs can be estimated and tracked against team velocity and cumulative flow. Bugs will be associated with the Requirements category.

  • Choose the second option when your team wants to manage bugs similar to tasks. Remaining work can be tracked for bugs and tracked against the sprint capacity and burndown. Bugs will be associated with the Task category.

  • Choose the last option if your team manages bugs separate from requirements or tasks. Bugs will be associated with the Bugs category.

Note

Your web portal uses either the New navigation or Previous navigation user interface. Choose the New navigation tab if the New Navigation feature is enabled. You'll see a vertical sidebar along with other navigational features when New Navigation has been enabled for the signed-in user or the organization. Choose Previous navigation when you see a top-level, blue-bar—indicating that New navigation isn't enabled. For more information, see Web portal navigation.

Note

Choose the New navigation tab for guidance. Azure DevOps Server 2019 supports the New Navigation user interface. For more information, see Web portal navigation.

Note

Choose the Previous navigation tab for guidance. TFS 2018 and earlier versions only support the previous navigation user interface. For more information, see Web portal navigation.

  1. Open your Kanban board. If you're not a team admin, get added as one. Only team and project admins can customize the Kanban board.

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

    Open board settings for a team, vert nav

  3. Choose Working with bugs and then choose the option that best meets your team's way of working.

    Settings, working with bugs dialog

  4. When done with your changes, choose Save.

  5. To see the changes, open or refresh the team's backlog or Kanban board.

Choose the Previous navigation tab for guidance. New navigation isn't supported for TFS 2018 and earlier versions.

Nested items

Tip

If, after refreshing a backlog or board, and you don't see bugs where you expect them, review How backlogs and boards display hierarchical (nested) items. Only leaf nodes of nested items will appear on the Kanban or task boards.

When you manage bugs with requirements or with tasks, they'll show up on one or more of your Agile tool backlogs and boards. However, if you nest items—create parent-child links of items that belong in either the Requirements or Task categories—then not all items may appear on your backlogs and boards. To learn more about how nested items are treated, see How backlogs and boards display hierarchical (nested) items.

Add other work item types to your backlogs or boards

Bugs are a common item that teams want to track, and choose how they track it. See Manage bugs for more guidance.

However, what if you want to track other work item types (WITs) on your backlogs and boards?

You can add other WITs—such as change requests, issues, or impediments— by customizing your process or project, based on the process model you use. For details,

You can add other WITs—such as change requests, issues, or impediments— by customizing your process or project, based on the process model you use. For details, see Add a work item type to a backlog and board.

For an overview of process models, see Customize your work tracking experience.