Organize your backlog, map child work items to parents

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

After you've added features or epics to your portfolio backlog, you can quickly organize your backlog by mapping backlog items to them. With features and epics, you can quickly add and group items into a hierarchy, drill up or down within the hierarchy, reorder and reparent items, and filter hierarchical views.

In this topic you'll learn:

  • How to change the backlog view to show the tree hierarchy
  • How to group backlog items under a feature or epic using the Mapping pane
  • How to reparent items using drag-and-drop or the Change parent option

Show parents and expand the tree hierarchy

From the product backlog page, set Parents to Show when you want to drill up or down within the hierarchy, set Parents to Show. You can also drag and drop items to reparent items from this view.

Hierarchical view of backlogs

Use the expand expand icon and collapse collapse icon icons to expand or collapse one level of the hierarchy.

Collapsed hierachical view

Map items to group them under a feature or epic

If you've already created your backlog, and now you want to organize it, you can do that most easily by mapping them.

To map a backlog item under a feature, you first turn mapping on from your backlog (Backlog items, Stories, or Requirements). Next, find the Unparented backlog items group by turning the Parents control to Show. Unparented backlog items will appear at the end of the parented set of backlog items.

Drag items that are currently unparented to the feature under which they belong. Also, you can drag a backlog item to a different feature to change its parent. This mapping creates parent-child links from feature to user stories, which is captured in the Links tab icon (links) tab.

Map a backlog item to a portfolio backlog work item


Feature availability: Multi-select of work items on the backlog and sprint backlogs is supported from VSTS and TFS 2015.1 or later versions. This feature works in the same way as multi-select works within query results.

It's the same process to map features to epics. From the Features backlog, drag features to an epic listed under the mapping pane.

Change parent (re-parent) and reorder items

When you need to change the order or grouping, simply drag the item to its new location.

You can re-parent an item using the mapping pane, or simply drag it within the hierarchy to change its parent.

Reparent or reorder work items on a backlog

You can only re-parent backlog items under other features, and features under other epics.

Also, to change an item's priority within a group, you can drag the item up or down within its hierarchical group. This works the same as when you moved items into priority order on your product backlog.

Change parent of multiple backlog items


Feature availability: The Change parent… menu option from the backlog page is supported from VSTS.

From the product backlog you can multi-select several work items and choose Change parent… to link the items to a parent work item item.

Change parent of several backlog items


The images you see from your web portal may differ from the images you see in this topic. These differences result from updates made to VSTS or your on-premises TFS. However, the basic functionality available to you remains the same unless explicitly mentioned.