Configure your backlog view in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Backlogs help teams define, prioritize, and organize work hierarchically while assigning tasks to iterations and forecasting progress. Each backlog is a shared team resource, so changes to items, priorities, and parent-child links update for all team members in real time.

This article shows you how to configure your backlog view options - including backlog levels, view settings, column options, and filtering - to align with your team's workflow and project requirements.

Prerequisites

Category	Requirements
Project access	Project member.
Permissions	Member of the Contributors group.
Access levels	- To reorder a backlog or use the Forecast tool: At least Basic access. Users with Stakeholder access can't reorder backlog items or use the Forecast tool. For more information, see Stakeholder access quick reference.
Configured backlogs	Both product and portfolio backlogs set up for your team.

Tip

You can't sort your backlog directly by selecting a column header. To view a sorted list, select Create query from your backlog. Save and open the query, and then modify it to a flat list query if needed to apply sorting to the results. For more information about queries, see Use the query editor to list and manage queries.

Backlog configuration options

Customize your backlog view by using these configuration tools:

• Expand or collapse one level: Show or hide hierarchical work item relationships.
• Column options: Select which fields display as columns.
• Backlog level selector: Switch between product and portfolio backlogs.
• View options: Control visibility of parents, forecasting, filters, and planning panes.
• Filter toolbar: Find specific work items by keywords, tags, or field values.

Each backlog level (Stories, Features, Epics) maintains separate configuration settings that persist across sessions.

Expand and collapse the hierarchy

Backlog levels default to a collapsed view that shows only items for that level. Use the and icons to show or hide one level of the hierarchy. These settings don't persist when you go to other pages.

Use backlog levels

Your team administrator configures available backlog levels, which might include custom work item types. Each backlog automatically applies your team's Area paths and Iteration paths filters.

Note

Before configuring these tools, review Create your backlog to ensure your setup supports your team's requirements.

Use the backlog level selector (next to the View options icon) to switch between Product Backlog and Portfolio backlog levels. Available options vary by process model and customizations, as shown in the following table.

Agile process

Scrum process

Basic process

CMMI process

Customized process

For more information, see Select backlog navigation levels for your team.

Use the view options menu

The View options menu controls the following options.

• Parents: Show hierarchical parent-child relationships. Use this option to add children, reparent, or view rollup columns.
• Forecasting: Show forecast tool and lines. Available only for first-level backlogs with assigned Story points, Effort, or Size.
• In Progress Items: Show items in In progress workflow states. When off, hides items in Active, Committed, or Resolved states. See workflow states and state categories.
• Completed Child Items: Show completed child items. Turn on when reviewing rollup columns.
• Keep hierarchy with filters: Maintain hierarchy when filtering.
• Mapping: Show Mapping pane for drag-and-drop linking to parents. Not available at the highest backlog level.
• Planning: Show Planning pane for drag-and-drop assignment to Iteration paths.

Use the filter toolbar

Filter work items by keywords, tags, assignments, or fields configured in Column options. Select the Filter icon to activate filtering.

When active, filtering displays a flat list and temporarily suspends the hierarchical view, even if Parents is enabled. The filter toolbar stays visible until you close it.

Important

While filtering is active, reordering (stack ranking) and the Forecast tool are disabled. Clear the filter to resume these actions.

For more information, see Filter backlogs, boards, and plans.

Filter your backlog and maintain the hierarchy

Filter your backlog while preserving hierarchy by enabling Parents and Keep hierarchy with filters in the View options menu.

Use these options to filter by team members, work item types, paths, or keywords while maintaining the hierarchy. Matching items appear in bold text.

Add work items quickly

Quickly capture work items and refine details later. Use backlog queries to triage and enhance items after adding them.

1. Choose the backlog level where you want to add new work items.

2. From the View options menu, turn Off Parents and Forecasting to simplify the view.

3. (Optional) Configure more settings:

   • In progress items: Show or hide items currently in progress.
   • Column display: Minimize columns or select specific fields, streamlining your view.

4. Add new work items:

   • Select the New work item icon.
   • Enter a title for the work item.
   • Select Add to top or use Change destination to choose another destination.
     • Recommendation: Add items to the bottom if your team prioritizes backlog items regularly.
   • Select Enter to add the work item.

   

   Work items are automatically assigned the default Area path and Iteration path configured for the team.

   Note

   If you have Stakeholder access, you can only add work items to the bottom of the backlog. For more information, see Stakeholder access quick reference.

For more detailed instructions, see the following articles:

• Create your product backlog
• Define features and epics

Prioritize your product backlog

Prioritize your backlog to ensure the most important work items are addressed first:

1. Choose the backlog level you want to prioritize (Stories, Features, Epics).

2. From the View options menu, turn Off the Parents option to simplify the view.

3. Reorder work items:

   • Drag and drop: Select and drag work items up or down to adjust priority.
   • Keyboard shortcuts: Hold Alt and use arrow keys to move items.

   

Tip

To reorder many items at once, multiselect items and use Move to position, Move to top, or Move to bottom. You can also bulk-edit priority through Excel. For more information, see Backlogs, portfolios, and Agile project management.

Note

Priority changes affect all team members and update automatically when they refresh their backlogs. A background process updates the Stack rank (Agile, Basic, and CMMI processes) or Backlog priority (Scrum process) fields. These fields track relative ranking and are assigned separately for each backlog level. By default, these fields don't appear on work item forms.

Some backlogs might restrict reordering due to portfolio management or nested items. For more information, see:

• Backlogs, portfolios, and Agile project management: Work with multi-team ownership of backlog items
• Fix reordering and nesting issues

Prioritize a portfolio backlog

Portfolio backlog prioritization works like product backlog prioritization, except you prioritize child items within each portfolio item. Each backlog level (Stories, Features, Epics) supports separate priority ordering.

Prioritize portfolio items:

1. Select the portfolio backlog level you want to prioritize.
2. Turn Off the Parents view option.
3. Drag work items up or down within the backlog.

Prioritize child items:

1. Expand each portfolio item.
2. Drag each child item up or down within the expanded item.

Link work items to a parent (mapping)

Quickly link work items to parent portfolio items by dragging them within your backlog view.

Tip

Before mapping, add and prioritize the portfolio backlog items you want to link to. The Mapping pane lists portfolio items in priority order.

1. Choose the backlog level where you want to link work items (for example, Stories to Features).

2. Select View options.

3. Select Mapping to open the Mapping pane. The pane lists next-level portfolio items for the current team.

4. (Optional) To map items to parents owned by a different team, select the team from the team selector in the Mapping pane.

   

5. Drag work items from the backlog and drop them onto the desired portfolio item in the Mapping pane.

   The system automatically creates a parent-child link and the backlog item's text turns bold briefly.

   To select multiple work items:

   • Sequential selection: Hold Shift to select a range of items.
   • Non-sequential selection: Hold Ctrl to select individual items.
   • Drag the selected items to create links.

6. (Optional) Within an expanded hierarchical view, drag a work item to a different parent to reparent it.

Tip

To view unparented work items, add the Parent field as a column. The parent item's Title appears for linked work items.

For more information, see Organize your backlog and map child work items to parents.

Add child items to a portfolio backlog item

1. Select the portfolio backlog level (such as Features) where you want to add items.

2. Select Add User Story, Bug for the feature you want to add the child item to. Labels might differ based on your process and customizations.

3. In the work item form, enter a Title and any required fields. Save the work item.

   The new child item appears under the parent feature when you expand it.

For more information, see Define features and epics, add child items.

View or find unparented work

1. Select the backlog level you want to inspect for unparented items.

2. Open View options and select Parents.

3. Scroll to the bottom and expand Unparented Stories, Unparented Features, or similar entries. Unparented work items are listed under these entries.

   

Assign work to a sprint or iteration

Use the Planning pane to assign work items to an Iteration path or sprint.

1. Ensure your team selects all Iteration paths you want to show in the Planning pane.

2. Choose the backlog level that contains the work items you want to assign.

3. Open View options, turn Off Completed child items, and choose Planning.

4. Drag work items from the backlog to the desired sprint in the Planning pane. The system creates assignments in the background. The backlog item turns bold briefly as the system saves changes. The work item moves to the target sprint in the Planning pane, and the Iteration path updates on the work item form.

   To select multiple items, hold Shift for sequential items or Ctrl for individual items, and then drag the selected items.
   

Forecast a backlog

The Forecast tool is available only for the product backlog. To forecast your backlog:

1. Ensure your team selects future Iteration paths.

2. Choose the backlog level for your team.

3. (Optional) Add the Story points, Effort, or Size field as a column based on your process.

4. Open View options and turn Off Parents, In progress items, and Completed child items. Turn On Forecast.

5. Enter a velocity estimate in the Forecasting based on velocity box.

6. Review the forecast lines that appear, similar to the ones shown in the following image.

   The forecast tool doesn't reference iteration assignments made to product backlog items.

Tip

To reprioritize items, drag them with forecast lines shown. You can also use the Planning pane with the Forecast tool turned on.

For more information, see Forecast your product backlog.

Troubleshoot common issues

Use the following table to resolve common issues when you configure your backlog view.

Problem	Cause	Resolution
You can't drag items to reorder the backlog.	Stakeholder access.	Request Basic access. For more information, see Stakeholder access quick reference.
The Forecast tool doesn't appear in View options.	You're not on a first-level (product) backlog, or items don't have Story points, Effort, or Size assigned.	Switch to the product backlog and add an estimation field to your work items. For more information, see Forecast your product backlog.
Forecast lines don't update or reordering doesn't work.	Filtering is on.	Clear the filter. Reordering and the Forecast tool are disabled while filtering is active.
The Mapping pane is empty.	No portfolio items exist for the selected team, or the wrong team is selected.	Create portfolio items, or select a team that owns portfolio items from the team selector in the Mapping pane. For more information, see Organize your backlog and map child work items to parents.
You can't sort the backlog by selecting a column header.	By design. Backlogs support drag and keyboard reorder only.	Select Create query from your backlog, save it as a flat-list query, and sort the query results. For more information, see Use the query editor to list and manage queries.
Expected work items don't appear in the backlog.	In progress items or Completed child items is turned off in View options.	Open View options and turn the relevant setting on.

Next step

Add rollup columns

Related content

• Create and manage your backlog
• Define features and epics
• Organize your backlog and map child work items to parents
• Configure team settings