Azure Boards FAQs

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

Find answers to frequently asked questions about using Azure Boards. For FAQs specific to queries or Microsoft Excel integration to add or modify work items defined in Azure DevOps, see Query FAQs and FAQs: Work in Excel connected to Azure Boards.

You can view a list of features that are on our roadmap for Azure Boards from the Features Timeline. To request a feature or up-vote a feature, go to our Developer Community page.

Access and permissions

Who can contribute to Azure Boards?

As a member of an Azure Boards project, you can use most features to track work. Limitations to select features are based on the access level and security group to which a user is assigned. Other limitations can be imposed based on work tracking permissions or custom rules. For more information, see Default permissions and access for Azure Boards.

How can noncontributors view or modify work items?

For private projects, you can grant access to an unlimited number of users by assigning them Stakeholder access. For public projects, anonymous users—ones who don't sign into the project—can view all work items. For more information, see Stakeholder access quick reference and Make a private project public.
Also, if your organization uses Microsoft Entra ID to manage user access, you can add external users to your organization.

You can grant access to an unlimited number of users by assigning them Stakeholder access. To learn more about the features they can access, see Stakeholder access quick reference.

How can I restrict viewing or modifying select work items?

You can restrict access by setting permissions for an area path. For more information, see the following articles:

Can caching affect rules applied to work items?

Yes. Conditional rules based on user or group membership get cached for your web browser. If you find yourself restricted to update a work item, you probably encountered one of these rules. For more information about conditional rules, see Rules and rule evaluation. If your cache stores outdated rules, you can wait for the client cache to expire within three days, or you can clear the cache.
To clear the cache, run the following command in the browser command window and then refresh the browser: window.indexedDB.deleteDatabase("wit")

What client tools support work tracking with Azure Boards?

Work items

Where should I start to learn about work items and work item types?

For an introduction to work items, see About work items.

How do I view all work items?

To view all work items defined in a project, open a query and add two clauses:

  • Work Item Type = [Any]
  • State = [Any]

From there, you can add filters to refine the query. For more information, see Create and save managed queries with the query editor.

Can a work item be assigned to several users or a user group?

No. Work items can only be assigned to a single user. Also, you can only add a user that is available from the people picker.

The main method to group work is to assign it to the same area path. Area paths are used to group work items by product, feature, or business areas and to support teams responsible for work assigned to those areas. In addition, you can group work under a parent work item using parent-child links, referred to as a hierarchical grouping.

For a discussion of these two usages and the tools they support, see Configuration and customization of Azure Boards, Area paths, product teams, and portfolio management.

How do I mark a task or work item as a milestone task?

Milestone markers aren't used in Azure Boards work tracking, except for Delivery Plans. Delivery Plans provide a calendar view and allow you to define a milestone marker. For more information, see Review team Delivery Plans.

However, you can use one or more of the following options to mark a work item as a milestone:

How can I best track dependencies?

You can track dependencies between work items by linking them using a related or other link type. See Link work items to other objects.

You can view dependencies using Delivery Plans.

If you're tracking dependencies across one or more organizations, you might want to use the Dependency Tracker.

What determines which work item type should be a parent for another work item type?

Each process defines four default backlog levels: the iteration backlog, requirement backlog, feature and epic portfolio backlogs. The work item types added to each backlog level are the natural work item types to form parent-child relationship and group work items into a hierarchy. For more information, see Organize your backlog, map child work items to parents. To customize the process, see Customize your backlogs or boards, Edit or rename the requirement backlog.

How do I copy or clone a work item with all linked items?

With Azure Boards (cloud service), you can choose to copy child work items when copying a work item. For more information, see Copy or clone work items.

This feature isn't supported at this time for Azure DevOps 2019 and earlier versions. Copying a work item doesn't copy any parent-child linked work items. However, is available for Azure DevOps Server 2020.1 update and Azure Boards (cloud service).

The easiest way to accomplish the task of copying many work items with child items is to create parent-child links to new work items using Excel. To learn how, see Bulk add or modify work items with Excel, Add a hierarchy of linked work items.

Other solutions include employing one of the following Marketplace extensions:

How do I bulk modify a rich-text field?

Automation rules

Is there way to make the parent active when a child is active?

Yes, you can set your backlog level to include two different rules. The first rule it to set the parent as active when any of its children are set to active. The second rule is to set parent to resolved or closed when all the children are closed. These rules can be configured for backlog level. For more information, see Automate work item state transitions

Why are my work items automatically changing state?

Work items automatically change state after your team administrator set up automation rules on the backlog. Create rules to automatically set the state to active or closed depending on the state change of its children. For more information, see Automate work item state transitions.

Why are the rules not triggering when I reactivate a child item?

Rules only trigger when the state of the child item moves from New to Active or into Closed. Rules don't trigger when the state of the child item moves from Closed back to Active. This is currently by design.

Can I set automation rules per work item type or state?

No, the rules are applied to all work item types in that backlog level. We use state categories instead of states because state categories are consistent across all work item types.

Can I set up automation rules for user stories but not for features or epics?

Yes, rules are configured per backlog level. Automation rules on the user stories backlog don't affect features or epics. But, you can also set up rules separately for features and epics. For more information, see Automate work item state transitions.

Why are automation rules not working if the child or parent items belongs to a different team or project?

Rules only trigger if both the parent and children belong to the same team. We don’t want rules automatically triggered for items that belong to other teams. For more information, see Automate work item state transitions.

Backlogs and boards

What's the difference between a backlog and a board?

Each backlog and board represents a filtered set of work items based on team area path and iteration path assignments. Backlogs list work items, boards display work items as cards. To understand how the filtering is applied, see About teams and Agile tools, Team defaults referenced by backlogs and boards.

How do I add a backlog or board?

To add a backlog or board, you add a team. Each team is configured with its own set of backlogs and boards as described in About teams and Agile tools. Each team can customize these Agile tools.

What limits should I be aware of?

Azure DevOps imposes limits such as the number of work items that display on a backlog or board, numbers of teams you can define, and more. For a full list, see Work tracking, process, and project limits.

How do I migrate my existing backlog to Azure Boards?

How do the three types of backlogs--product, portfolio, and sprint backlogs--differ?

Each backlog lists a filtered set of work items based on the team's selected area path, iteration paths, and work item types.

  • Product backlog: By default lists User Stories (Agile), Issues (Basic), Product Backlog Items and Bugs (Scrum), or Requirements (CMMI). Provides options to show Parents, Forecast, and In Progress or Completed child items.
  • Portfolio backlog: By default lists Features (all process models) for the Features backlog, and Epics (Agile, Scrum, and CMMI) for the Epic backlog. Provides options to show Parents and In Progress or Completed child items.
  • Sprint backlog: By default lists all product backlog items assigned to the selected iteration, regardless of status. Provides options to show Work details.

Can I define sprints and use them with my Kanban board?

Yes. You can assign sprints to work items and filter your Kanban board based on the iteration path. For more information, see Filter your Kanban board.

If I manage bugs with tasks, can I add bugs as a checklist to a requirement?

No. Task checklists only support the task work item type.

How do I create a view of the critical path?

Azure DevOps doesn't provide a native view of the critical path. In part, as Agile methodologies favor a Minimum Viable Product (MVP) over Critical Path Management (CPM). By using MVP, you identify the shortest path and dependencies by prioritizing epics, features, stories and tasks.

That said, we recommend that you use Delivery Plans to view dependencies and a calendar view of work.

If your organization supports connection to Microsoft Project, you might find more Marketplace extensions that support connection of Azure DevOps to Microsoft Project.

For more context, see The Critical Path on Agile Projects and Running a lean startup on Azure DevOps.

Rollup

How can I get a rollup of Story Points, Effort, or other work item fields?

Rollup columns allow you to view progress bars or totals of numeric fields or descendant items within a hierarchy. Descendant items correspond to all child items within the hierarchy. You can add one or more rollup columns to a product or portfolio backlog. You can add rollup columns to a product or portfolio backlog. See {Display rollup progress or totals](backlogs/display-rollup.md).

Rollup provides summed values of select fields for all child work items of a parent. For more information, see Rollup of work and other fields.

Can I get a rollup of team capacity?

No. The data entered for team capacity isn't stored in the regular data stores.

Kanban boards

Is there a way to widen columns on a Kanban board?

No. This feature isn't supported. It's a suggested feature, which you can upvote by going to our Developer Community page.

Can I query based on Kanban board columns?

Can I view a query as a Kanban board?

Yes, by adding the Query Based Boards Marketplace extension.

Is there a way to copy a Kanban configuration to another team?

Yes, by adding the Azure Boards Kanban Tools Marketplace extension.

Can I list items based on their Kanban column assignment?

Yes, you can track column moves on a Kanban board by using the Board Column and Board Column Done fields.

What if I get the error message, "The column configurations aren't valid"?

If you get the following error when you open your Kanban board, you need to correct the configuration. The main reason for this error is that the workflow states of work item types added to the Requirement category aren't mapped to the column.

Screenshot that shows a configuration error message on a Kanban board.

Select Correct this now to open the Settings dialog. In the following example, two new states are added: Triaged for bug, and Investigate for user story. Each state is then mapped to an existing or new column. After each state is mapped to a column, the Kanban board displays the work items assigned to these states.

Screenshot showing Kanban board settings, columns.

Can I use swimlanes and set up swimlane rules?

Yes, you can add or remove swimlanes on your Kanban board. You can also set up swimlane rules, where when certain conditions are met, Azure Boards automatically moves work items into specific lanes.

Work item templates

Where should I start to learn about work item templates?

You can define work item templates for teams you belong to. To define work item templates to specify defaults for select fields, see Use templates to add and update work items.

How do I set a default template for a team?

The feature to set a default template for a team isn't a supported feature at this time.

Can I copy a work item template to another team or project?

No. This feature isn't supported at this time.

Example request: When creating a template, I would like the Parent User Story to be defaulted. There isn't a predetermined field in the template. Would/could this function be under a user-defined selection?

No, there's no native support for creating hierarchy templates. In particular, you can't specify a default parent work item. You can, however, quickly copy tasks, bugs, and other items using Excel to apply parent-child links in a tree list. Or, you can use a Kanban board to add child tasks, backlog items, or features. For more information, see:

Alternatively, you might find a solution for creating child work items by installing one of the following Marketplace extensions:

How do I delete a work item template?

From the work item type page, choose the actions icon for an existing template and select the Delete option.

Delete template

GitHub integration

How do I connect Azure Boards to GitHub?

Azure Boards integrates with GitHub for Azure DevOps Server 2019 and later versions. For more information, see Azure Boards & GitHub.

Can I specify the status when linking a work item to a GitHub commit or PR?

No. This feature isn't supported at this time.

Configuration and customizations

What is configurable or customizable?

Configuration and customization of Azure Boards occurs at the project and team level. For an overview of what you can configure and customize to support your business needs, see Configuration and customization of Azure Boards.

For FAQs on configuration and customization, see Azure Boards Configuration and Customization FAQs.