Define features and epics

Last Update: 7/14/2017

Team Services | TFS 2017 | TFS 2015 | TFS 2013

While many teams can work with a flat list of items, sometimes it helps to group related items into a hierarchical structure. Perhaps you like to start with a big picture and break it down into smaller deliverables. Or, you've got an existing backlog and now need to organize it.

No matter your starting point, you can use portfolio backlogs to bring more order to your backlog. Use your backlogs to plan your project and to:

  • Manage a portfolio of features that are supported by different development and management teams
  • Group items into a release train
  • Minimize size variability of your deliverables by breaking down a large feature into smaller backlog items

Feature availability: Epics are supported on Team Services and TFS 2015 and later versions. Each team can choose the backlog levels that are active as described in Select backlog navigation levels for your team.

With portfolio backlogs 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. Portfolio backlogs are 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.


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 Team Services or your on-premises TFS, options that you or your admin have enabled, and which process was chosen when creating your team project—Agile, Scrum, or CMMI. However, the basic functionality available to you remains the same unless explicitly mentioned.

Work items are denoted with icons for Team Services and TFS 2017.2 and later versions. For an overview of changes in the navigation experience and working within the user and administration contexts, see Work in the web portal.

View a backlog or portfolio backlog

To focus on one level of a backlog at a time, click the name of the backlog you want to view. If you don't see all three backlog levels— Epics, Features, and Backlog items— you can enable them for your team.

For example, when you click Epics, you'll see a list of all Epics in your team's active area paths. From there, you can drill down to see child features and backlog items.

Hierarchical view of backlogs

Click Features to see a list of all features in your team's active area paths.

Add features and epics

Just as you can add items to your product backlog, you can add items to your features and epics backlogs. Here, we've added six features.

Features backlog

You can add epics in the same way. Simply open the Epics backlog.

Open each item (double-click, or press Enter to open the selected item) and add all the info you want to track. Enter as much detail as the team needs to understand the scope, estimate the work required, develop tests, and ensure that the end product meets acceptance criteria.


Reminder: The following screenshots illustrate the work item form for Team Services. Your forms may differ depending on what you have enabled, what process you chose when creating your team project—Agile, Scrum, or CMMI—and what platform you're working from, Team Services or TFS.

Feature work item form, Agile process, Add details to a feature

Field Usage
Value Area The area of customer value addressed by the epic, feature, or backlog item. Values include:
  • Architectural – technical services to implement business features that deliver solution
  • Business (Default) – services that fulfill customers or stakeholder needs that directly deliver customer value to support the business
Story Points
Provide a relative estimate of the amount of work required to complete a Feature or Epic. Use any numeric unit of measurement your team prefers. Some options are story points, time, or other relative unit.
Business Value Specify a priority that captures the relative value of an Epic, Feature, or backlog item compared to other items of the same type. 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.
Time Criticality A subjective unit of measure that captures the how the business value decreases over time. Higher values indicate that the Epic or Feature is inherently more time critical than those items with lower values.

Target Date

Specify the date by which the feature should be implemented.

Add child items

With your features defined, you're ready to add child items to them. From any backlog, you can add child items. You can add features to epics, and backlog items to features.

Here we add a product backlog item as a child to the Customer Web - Phase 1 feature.

Add a child item to a backlog work item

Whenever you see the plus plus icon , you can add a child item. The work item always corresponds to the hierarchy of work item types that are defined for your team project.

For Scrum team projects, your hierarchy is as shown:

Hierarchical view of backlogs

Because teams can also set bugs as tasks, bugs can be added as children of PBIs.

The work item types you'll see depends on the process you selected to create your team project.

If you want bugs to show up on your backlog and you're not seeing them, enable them for your team.

Try this next

Once you've defined features and epics, you can now organize your backlog by mapping or drag-and-drop operations.

Portfolio backlogs are not only a great way to organize your project plan, but also a great way to provide visibility of project plans across enterprise teams. With portfolio backlogs, management teams can gain insight into project status across all their development teams.


To understand the features supported on each backlog and board, and how each display hierarchical items, see Backlogs, boards, and plans. To learn how to track progress across teams, see Visibility across teams.

A few things to keep in mind...

Backlog controls

Control Function
Backlog Switch to backlog view
Board Switch to Kanban board view
Mapping: On/Off Turn mapping Off/On
Parents: Show/Hide Turn tree hierarchy on/off
In progress items: Show/Hide Show or hide list of backlog items whose State is active or in progress
Settings icon Configure team settings: Backlogs, Working days, Working with bugs
full screen icon/exit full screen icon Enter or exit full screen mode
expand icon / collapse icon Expand or collapse one level of the tree hierarchy
mail icon Email a copy of your backlog
Filter Turn tag filtering On/Off

Note that even if you have show parents turned on, the Create query and mail mail icon controls will only list items at the currently selected level.

See also Keyboard shortcuts.

Filter backlogs, boards, and queries

If you have many items listed in your product or portfolio backlog, Kanban board, or query results—and you want to focus on a subset of them—you can filter the set.

Filter based on keywords

You can use keywords to filter your backlogs, Kanban boards, and query results. The filter function picks up work items based on any visible/displayed column or field, including tags, based on the keyword that you enter. Also, you can enter a value for an ID, whether or not the ID field is visible.

Here, we filter the backlog to only show items that include 'Web' in any one of the displayed column fields.

Apply text filter

The filtered set is always a flat list, even if you've selected to show parents.

The filter criteria ignores the following characters when the field value starts with the character: {, (, [, !, @, #, $, %, ^, &, *, ~, `, ', ".

Filter based on tags

If you've added tags to your work items, you can filter your backlogs, Kanban boards, and query results using the tag filter icon tag filter. For backlogs and query results, add Tags as a column option prior to filtering on tags.

To filter the Kanban board using tags, make sure that you first customize cards to Show tags. See also, Filter the Kanban board for additional options.

To learn more about filtering using Tags, see Add tags to work items to categorize and filter lists and boards, Filter lists using tags

Move work items to a sprint from any backlog or board

You can drag any work item from any backlog or board to a sprint. Even when working from the Kanban or task board, you can drag a work item onto a sprint to change it's iteration path.


Feature availability: This feature is supported from Team Services and the web portal for TFS 2015.1 and later versions.