Azure Boards FAQs

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

Find answers to frequently asked questions when 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 the majority of 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. To learn more, see Default permissions and access for Azure Boards.

How can non-contributors 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. To learn more, see Stakeholder access quick reference and Make a private project public.
Also, if your organization uses Azure Active Directory 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. To learn more, see the following articles:

Can caching impact rules applied to work items?

Yes. Conditional rules based on user or group membership are cached for your web browser. If you find yourself restricted to update a work item, you may have encountered one of these rules. If you believe you've encountered an issue that doesn't apply to you, see Work item form IndexDB caching issues. To learn more about conditional rules, see Rules and rule evaluation.

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. To learn more, 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 and Linking, traceability, and managing dependencies.

You can view dependencies using Delivery Plans (Preview).

If you are tracking dependencies across one or more organizations, you may 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. To learn more, 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 details, 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 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?

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. For details on usage, see Backlogs, Boards, and Plans.

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?

There are a number of limits Azure DevOps imposes 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.

To learn more, see Tasks supported by Backlogs, Boards, Taskboards, and Plans.

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. To learn more, 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 may find additional Marketplace extensions that support connection of Azure DevOps to Microsoft Project.

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


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/

Rollup provides summed values of select fields for all child work items of a parent. To learn more, 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 is not a supported feature. It is 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.

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 is not a pre-determined field in the template. Would/could this be under a user-defined selection?

No, there is 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. To learn more, see:

Alternatively, you may 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. To learn more, 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.