TFS 2017 | TFS 2015 | TFS 2013
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.
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?
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?
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.
What's the recommended method to group work?
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:
- Simply prepend or append the word Milestone in the title of your work item
- Add a work item tag labeled Milestone
- Add a custom field labeled Milestone and populate it with a pick list of milestones
- Link work items using the Predecessor/Successor or Related link type to a milestone work item
- Assign the milestone work item to the sprint in which it's targeted for completion.
How can I best track dependencies?
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?
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, you may find that one or more of the following features supports both CPM and MVP. You gain access to these features by installing a Marketplace extension.
If your organization supports connection to Microsoft Project, you may find additional Marketplace extensions that support connection of Azure DevOps to Microsoft Project.
How can I get a rollup of Story Points, Effort, or other work item fields?
Can I get a rollup of team capacity?
No. The data entered for team capacity isn't stored in the regular data stores.
Is there a way to widen columns on a Kanban board?
No. This is not a supported feature at this time. 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.
Can I create a work item template that creates links to other work items?
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:
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.
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.