Skip to content

Commit e78e76b

Browse files
committed
added sections from deleted file during content merge, support links to
1 parent 7eb33fc commit e78e76b

File tree

1 file changed

+52
-1
lines changed

1 file changed

+52
-1
lines changed

docs/boards/backlogs/create-your-backlog.md

Lines changed: 52 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.author: chcomley
1010
author: chcomley
1111
ms.topic: how-to
1212
monikerRange: '<= azure-devops'
13-
ms.date: 07/01/2025
13+
ms.date: 07/15/2025
1414
#customer intent: As a team member, I want to understand how to create and manage backlogs in Azure Boards to improve my team's workflow.
1515
---
1616

@@ -205,6 +205,8 @@ Use these essential fields to estimate effort and define requirements for sprint
205205
| [Acceptance Criteria](../queries/titles-ids-descriptions.md) | **Define "Done"** - Describe specific criteria for completion. Establish shared understanding between team and customers for acceptance testing. |
206206
| [Impact Assessment](/previous-versions/azure/devops/boards/work-items/guidance/cmmi/guidance-requirements-field-reference-cmmi) | **Assess risk (CMMI only)** - Document customer impact of not implementing the requirement. |
207207

208+
209+
208210
<a id="show-hide-in-progress"></a>
209211

210212
## Show or hide In Progress Items
@@ -228,6 +230,55 @@ Use the **View options** selector to toggle **Completed Child items** visibility
228230

229231
[!INCLUDE [temp](../includes/note-closed-items.md)]
230232

233+
## Review checklist for work items, backlogs, and boards
234+
235+
If you don't see the work items you expect on your [product Backlog](create-your-backlog.md) or [board](../boards/kanban-quickstart.md), complete the following checks:
236+
237+
1. Make sure you've selected the team backlog or board of interest. To learn how, see [Use breadcrumbs and selectors to go to and open artifacts](../../project/navigation/use-breadcrumbs-selectors.md).
238+
239+
2. [Create a query](../queries/using-queries.md) of your backlog items, specifying the work item types that belong to your Requirements category and the Area Path associated with your team, for example:
240+
241+
> [!div class="mx-imgBorder"]
242+
> ![Requirement category query](media/setup-backlog/requirements-query.png)
243+
244+
3. Add the <strong>State</strong>, <strong>Area Path</strong>, and <strong>Iteration Path</strong> fields to the [column options](set-column-options.md).
245+
246+
4. Check the query results and that the values of the work items you expect to show up on your backlog meet these criteria:
247+
- <strong>Area Path</strong> belongs to your team's area path(s)
248+
- <strong>Iteration Path</strong> belongs under your team's default iteration path
249+
- <strong>State</strong> isn't Closed, Completed, Done, or Removed.
250+
251+
> [!NOTE]
252+
> You can also filter your product backlog to show or hide work items that are in an **In Progress** state category, corresponding to an Active, Resolved, Committed, Doing workflow state.
253+
254+
## Other factors that can affect work items in your backlogs and boards
255+
256+
The following settings can influence the type and number of work items that appear in your backlogs and boards.
257+
258+
- In your board, newly added work items may not appear if they're stack ranked lower within the product backlog. By choosing **Show more items**, you can cause the board to refresh and display more work items.
259+
260+
> [!div class="mx-imgBorder"]
261+
> ![Boards, Show more items](media/setup-backlog/show-more-items.png)
262+
263+
- If you have nested work items that belong to the same category, only leaf nodes may appear on the board (for TFS 2018.1 and earlier versions). For this reason, we recommend that you don't nest work items of the same work item type or belonging to the same category. For more information, see [Fix reordering and nesting issues, How backlogs and boards display hierarchical (nested) items](resolve-backlog-reorder-issues.md).
264+
265+
- If you've turned off the **In Progress** view, then those work items where work has started won't appear in the backlog list.
266+
267+
::: moniker range=">= azure-devops-2020"
268+
> [!div class="mx-imgBorder"]
269+
> ![Backlogs, View Options, Hide In Progress](media/setup-backlog/hide-in-progress-s155.png)
270+
::: moniker-end
271+
272+
- Work items appear in the priority order in which they're added or moved to. This order or sequence is managed by the **Stack Rank** (Basic, Agile, and CMMI processes) or **Backlog Priority** (Scrum) field. For more information, see the Stack rank section in [Backlogs, portfolios, and Agile project management](backlogs-overview.md#stack-rank).
273+
274+
- Each backlog can display up to 999 work items. If your backlog exceeds this limit, then you may want to consider adding a team and moving some of the work items to the other team's backlog.
275+
276+
- Sprint backlogs show only those work items that meet the team's area path and the **Iteration Path** defined for the sprint.
277+
278+
- Inheritance process model: If an administrator [disables or deletes a work item type](../../organizations/settings/work/customize-process-work-item-type.md#enable-disable), it doesn't appear on backlogs and boards.
279+
280+
- On-premises XML process model: If an administrator [deletes or destroys a work item type](../../reference/witadmin/witadmin-import-export-manage-wits.md), it doesn't appear on backlogs and boards.
281+
231282
## Next step
232283

233284
With your backlog in place, your team can begin work on the top-priority items. Now it's time to decide how you want to work as a team. Choose your team's workflow: Scrum for structured sprints or Kanban for continuous flow. You can use these methods independently or together.

0 commit comments

Comments
 (0)