title | titleSuffix | description | ms.custom | ms.service | ms.assetid | ms.author | author | ms.topic | monikerRange | ms.date |
---|---|---|---|---|---|---|---|---|---|---|
Create your product backlog in Azure Boards |
Azure Boards |
Learn how to add backlog items or user stories to plan your project, prioritize, and estimate deliverables in Azure Boards and Azure DevOps. |
boards-backlogs, seodec18, contperf-fy20q4 |
azure-devops-boards |
04df6b31-ef6c-4285-81a6-96768f03ecf4 |
kaelli |
KathrynEE |
quickstart |
<= azure-devops |
04/01/2022 |
[!INCLUDE version-lt-eq-azure-devops]
Your product backlog corresponds to your project plan, the roadmap for what your team plans to deliver. You create your product backlog by adding user stories, backlog items, or requirements. As shown in the following image, your backlog consists of a flat list of work items.
Note
The following image illustrates the product backlog image for a Scrum process for Azure DevOps Services. For the Agile, Basic, and CMMI process models, the Backlog items selection appears as Stories, Issues, and Requirements.
After you define it, you have a prioritized list of features and requirements to build. Your backlog also provides a repository of the information you need to track and share with your team. And, you can interactively filter the backlog to focus on a subset of work items.
[!INCLUDE temp]
Your backlog consists of a list of work items. You use work items to share information, assign work to team members, track dependencies, organize work, and more. Because the most important work appears at the top of the list, your team always knows what to work on next.
Note
Your product backlog is one of three classes of backlogs available to you. For an overview of the features supported on each backlog and the two types of boards, see Backlogs, boards, and plans. If you're not seeing the work items you expect on your backlog, review Setup your backlogs and boards.
If you have a project, you have a backlog. Each project defines a default team and set of backlogs for that team. You only need to add a backlog when you want to support a new team. When you add a team, you add various team assets. A team admin can configure the assets to support the way the team works. To add a set of backlogs to support a new team, see Add a team.
Each team's set of backlogs are associated with one or more work item types. The work item type associated with a backlog depends on the:
- Process selected at project creation
- Team configurations
- Process customizations
The backlogs defined for each default process are:
::: moniker range=">= azure-devops-2019"
- Agile: Stories, Features, and Epics
- Basic: Issues and Epics
- Scrum: Backlog items, Features, and Epics
- CMMI: Requirements, Features, and Epics ::: moniker-end
::: moniker range="< azure-devops-2019"
- Agile: Stories, Features, and Epics
- Scrum: Backlog items, Features, and Epics
- CMMI: Requirements, Features, and Epics ::: moniker-end
::: moniker range=">= azure-devops-2019" You choose the backlog level from the backlog selector as shown in the following image.
:::image type="content" source="media/create-backlog/backlog-selector.png" alt-text="Choose backlog level, Backlog items, Stories, or Requirements.":::
::: moniker-end
::: moniker range=">= azure-devops-2019"
To customize your backlogs with custom work item types, add portfolio backlogs or other supported options. See the following articles, depending on the process your project uses:
- Inherited process model
- On-premises XML process model. ::: moniker-end
::: moniker range="< azure-devops-2019"
To customize your backlogs to add custom work item types, add portfolio backlogs, or other supported options, see On-premises XML process model.
::: moniker-end
[!INCLUDE temp]
From your web browser, open your product backlog.
::: moniker range=">= azure-devops-2020"
-
(1) Check that you've selected the right project, (2) choose Boards>Backlogs, and then (3) select the correct team from the team selector menu.
To select another backlog, open the selector and then choose a different team or select the View Backlog directory option. Or, enter a keyword in the search box to filter the list of team backlogs for the project.
[!TIP]
Choose the :::image type="icon" source="../../media/icons/icon-favorite-star.png" border="false"::: star icon to favorite a team backlog. Favorited artifacts (:::image type="icon" source="../../media/icons/icon-favorited.png" border="false"::: favorited icon) appear at the top of the team selector list. -
Check that you have selected Stories (for Agile), Issues (for Basic), Backlog items (for Scrum), or Requirements (for CMMI) as the backlog level.
:::image type="content" source="media/create-backlog/backlog-selector.png" alt-text="Choose backlog level.":::
-
(Optional) To choose which columns should display and in what order, choose the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon and select Column options. To learn more, see Change column options.
::: moniker-end
::: moniker range="azure-devops-2019"
-
Check that you selected the right project, and select Boards > Backlogs. Then select the correct team from the team selector menu.
To select another backlog, open the selector and then choose a different team or select the :::image type="icon" source="../../media/icons/home-icon.png" border="false"::: Browse all backlogs option. Or, enter a keyword in the search box to filter the list of team backlogs for the project.
[!TIP]
Select the :::image type="icon" source="../../media/icons/icon-favorite-star.png" border="false"::: star icon to make a team backlog a favorite. Favorite artifacts (:::image type="icon" source="../../media/icons/icon-favorited.png" border="false"::: favorite icon) appear at the top of the team selector list. -
Check that you selected Stories for Agile, Issues for Basic, Backlog items for Scrum, or Requirements for CMMI as the backlog level.
-
(Optional) To select which columns display and in what order, select the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon and select Column options. To learn more, see Change column options.
::: moniker-end
::: moniker range=">= azure-devops-2019" [!INCLUDE temp] ::: moniker-end
::: moniker range="tfs-2018"
On your web browser, open your team's product backlog and select the team from the project and team selector. Then select Work > Backlogs. Select the product backlog, which is Backlog items for Scrum, Stories for Agile, or Requirements for CMMI.
To select another team, open the project and team selector. Select a different team, or select the Browse option.
::: moniker-end
You can choose how you want to manage bugs. Some teams like to track bugs along with requirements on the backlog. Other teams like to track bugs as tasks completed in support of a requirement. The bugs then appear on their taskboard.
Before deciding, review Configure and customize, Treat bugs as requirements or tasks for guidance. Or, go directly to Show bugs on backlogs and boards.
Your backlog shows work that you plan to do or have started to work on. As soon as the State of a work item is set to Done or Completed, the work item no longer shows up on your backlog. You can use the backlog controls to filter or change your view.
Tip
If you already have defined a long list of items, you don't have to reenter them one at a time. Instead, use Import or update work items in bulk by using CSV files or Microsoft Excel to quickly import them to your backlog.
::: moniker range=">= azure-devops-2019"
-
Before you add work items, select :::image type="icon" source="../../media/icons/view-options-icon.png" border="false"::: View options and turn the slider for Parents and Forecasting to Off. Optionally, turn In Progress Items on or off.
-
To add a work item, select :::image type="icon" source="../../media/icons/blue-add-icon.png" border="false":::New Work Item and enter a title. Then press Enter or select Add to top. Work items are automatically assigned the default Area Path and Iteration Path selected for the team. To learn more, see Configure team settings.
[!NOTE]
If you have Stakeholder access , you can only add work items to the bottom of the backlog. For details, see Stakeholder access quick reference. -
Repeat this step to capture all your ideas as work items.
::: moniker-end
::: moniker range="tfs-2018"
To build your backlog, enter a title and select Add. If you don't see the Add link, select New to open the quick add panel. Optionally, set In progress items to Show or Hide. Work items are automatically assigned the default Area Path and Iteration Path selected for the team. To learn more, see Configure team settings.
Note
If you have Stakeholder access , you can only add work items to the bottom of the backlog. For details, see Stakeholder access quick reference.
Repeat this step until you capture all your main ideas.
::: moniker-end
Note
Depending on whether you create your project with Basic, Agile, Scrum, or CMMI, the items in your backlog might be called issues, user stories, PBIs, or requirements. All three are similar. They describe the customer value to be delivered and the work to be performed.
By default, user stories appear on Agile backlogs, issues on Basic backlogs, PBIs and bugs appear on Scrum backlogs, and requirements appear on CMMI backlogs.
After you have some items in your backlog, reorder them to create a prioritized list of work. Review and prioritize your backlog frequently to help your team know what's most important to deliver next.
Tip
You can't sort your backlog on a column. To view a sorted listed, select Create query. Save and open the query, and then sort the query results. To learn more about queries, see Use the query editor to list and manage queries.
To reorder your backlog, drag the work items. Or, if you prefer to use the keyboard, hold down the Alt key and use the up and down arrows.
Note
To reorder a backlog, you must have Basic or higher level access. If you have Stakeholder access, you can't reorder backlog items. For more information, see Stakeholder access quick reference.
Backlogs that participate in portfolio management or that contain nested same-type child items might not allow you to reorder the items. For more information, see these articles:
- Backlogs, portfolios, and Agile project management, Work with multi-team ownership of backlog items
- Fix reordering and nesting issues
Building and prioritizing your backlog provides a high-level roadmap. Before your team can start work on any item, however, they need more details. Capture the details within the work item form.
To open each item, double-click or press Enter. Then add all the information you want to track. Change one or more field values, add a description, or make a note in the Discussion section. You can also choose the :::image type="icon" source="../media/icons/icon-attachments-tab-wi.png" border="false"::: Attachments tab and drag a file onto it to share the file with others.
Enter as much detail as the team needs to:
- Understand the scope.
- Estimate the work required.
- Develop tests.
- Ensure that the end product meets acceptance criteria.
[!INCLUDE temp]
For example, here we assign the story to Raisa Pokrovskaya and we add a discussion note, at-mentioning Raisa.
Choose Save & Close when done.
For example, here we assign the issue to Raisa Pokrovskaya and we add a discussion note, at-mentioning Raisa.
Choose Save & Close when done.
For example, here we assign the product backlog item to Christie Church and set an Effort level of 8.
Choose Save & Close when done.
For example, here we assign the product backlog item to Jamal Hartnett and set Size to 8.
Choose Save & Close when done.
Tip
To plan a sprint, at a minimum, estimate the effort involved to implement each backlog item. To capture effort in the work item form, use Effort for Basic or Scrum, Story Points for Agile, or Size for CMMI.
:::row::: :::column span=""::: Field :::column-end::: :::column span="3"::: Usage :::column-end::: :::row-end:::
:::row:::
:::column span="":::
Effort, Story Points, Size
:::column-end:::
:::column span="3":::
Provide a relative estimate of the amount of work required to complete a PBI. For user stories and requirements, you capture estimates in Story Points and Size.
Most Agile methods recommend that you set estimates for backlog items based on relative size of work. Such methods include powers of 2 (1, 2, 4, 8) and the Fibonacci sequence (1, 2, 3, 5, 8, and so on). Use any numeric unit of measurement your team prefers.
The estimates you set for Effort, Size, or Story Points are used to calculate velocity and forecast sprints.
:::column-end:::
:::row-end:::
:::row:::
:::column span="":::
Business Value
:::column-end:::
:::column span="3":::
Specify a priority that captures the relative value of a PBI compared to other PBIs. The higher the number, the greater the business value.
Use this field when you want to capture a priority separate from the changeable backlog stack ranking.
:::column-end:::
:::row-end:::
:::row:::
:::column span="":::
Description
:::column-end:::
:::column span="3":::
Provide enough detail to create shared understanding of scope and support estimation efforts. Focus on the user, what they want to accomplish, and why. Don't describe how to develop the product. Do provide sufficient details so that your team can write tasks and test cases to implement the item.
:::column-end:::
:::row-end:::
:::row:::
:::column span="":::
Acceptance Criteria
:::column-end:::
:::column span="3":::
Define what "Done" means by describing the criteria for the team to use to verify whether the PBI or the bug fix is fully implemented.
::: moniker range=">= azure-devops-2019"
From the View options selector, you can choose to show or hide In Progress items. If you turn the In Progress control off, then items that are in the Active, Committed, or Resolved states or states that map to the In Progress category state won't appear in the backlog.
::: moniker-end
::: moniker range=">= azure-devops-2020" :::image type="content" source="media/create-backlog/in-progress-control-2020.png" alt-text="View options selector, In progress control"::: ::: moniker-end
::: moniker range="azure-devops-2019" :::image type="content" source="media/create-backlog/in-progress-control-2019.png" alt-text="View options selector, In progress control"::: ::: moniker-end
::: moniker range="tfs-2018" Choose In progress items show or hide In Progress backlog items. If you turn the In Progress items control off, then items that are in the Active, Committed, or Resolved states or states that map to the In Progress category state won't appear in the backlog. ::: moniker-end
You usually choose to hide In Progress items when you want to forecast work. To learn more, see Forecast your product backlog.
::: moniker range=">= azure-devops-2020"
From the View options selector, you can choose to show or hide Completed Child items.
:::image type="content" source="media/create-backlog/completed-child-items-control-2020.png" alt-text="View options selector, Completed child items control":::
You usually choose to show Completed child items when you want to view rollup columns.
You usually choose to hide Completed child items when you want to forecast work. To learn more, see Forecast your product backlog.
[!INCLUDE temp] ::: moniker-end
Now that you have a working backlog in place, your team can begin work on the top-priority items. From here, it's time to decide how you want to work as a team. Do you want to use Scrum or Kanban? You can use these methods independently or together.
[!div class="nextstepaction"] Scrum: Schedule sprints or Kanban
Teams that want the least overhead for tracking and estimating might prefer Kanban. Teams that like to work at a steady cadence and plot the details of their sprint plan might prefer Scrum and sprint planning.
::: moniker range=">= azure-devops-2020"
- Configure and customize Azure Boards
- Bulk modify work items
- Copy or clone work items
- Refine your backlog
- Display rollup progress bars or counts
- Product backlog controls
- Interactively filter backlogs, boards, queries, and plans
- Backlog priority or stack rank order
- Keyboard shortcuts
::: moniker-end
::: moniker range="< azure-devops"
- Bulk modify work items
- Copy or clone work items
- Refine your backlog
- Product backlog controls
- Filter product and portfolio backlogs
- Backlog priority or stack rank order
- Keyboard shortcuts
::: moniker-end