Add work items to plan and track your project (TFS)
TFS 2015 | TFS 2013
Feature availability: The new web form provides many additional features. If you connect to VSTS or the web portal for TFS 2017 or later versions, see Add work items to plan and track your project.
You add work items to plan and manage your project. You use different types of work items to track different types of work - such as tasks, features or user stories, test cases and bugs, risks or issues, and more. You can describe the work to be done, assign work, track status, and coordinate efforts within your team.
Different types of work items are used to track features, user experiences, code defects, tasks, and issues. You can link work items to one another, as well as to changesets and source code files. As the following image shows, each work item form comes with a number of controls, fields, and tabs.
Depending on the process you chose when creating your team project--Scrum,
Agile, or CMMI--the types of work items you can create will differ. For example, backlog items may be called product backlog items (PBIs), user stories, or requirements. All three are similar: they describe the customer value to deliver and the work to be performed.
For an overview of all three processes, see Choose a process.
Add work items to define new work
You can start adding work items once you connect to a team project. Here we show how to add work items from the web portal. For additional clients that you can use, see Clients that support tracking work items.
From a web browser, connect to the team project that you want to work in. For example, the Fabrikam, Inc. team navigates to
If you haven't been added as a team member, get added now.
From a team home page, you can choose the type of work item you want to create.
Enter a title and then save the work item. Before you change the default State, you must save it.
Update work items as work progresses
As work progresses, team members can update the state and reassign it as needed. While the workflow states differ for different work item types, they usually follow a progression from New or Active to Completed or Done. The following image shows the work flow states for a product backlog item. If you want to discard a work item, change the state to Removed.
Typical workflow progression:
Removed work items remain in the data store and can be reactivated by changing the State.
With each update, changes are recorded in the History field which you can view through the History tab.
To find work items based on their history, see History & auditing.
Link items to manage dependencies
By linking work items using Related or Dependent link types, you can track work that is dependent on other work. Each work item contains one or more tabs with link controls. These controls support linking the work item to one or more objects.
Link control tab from the web portal
Some work item types have two or more link control tabs. Each tab is designed to support specific types of links and restricts the types of link relationships made. To learn more, see Manage dependencies, link work items to support traceability.
Get the URL for a work item
From the web portal, simply copy the URL from the web browser address or open the context menu for the work item ID hyperlink and choose the Copy shortcut.
In Visual Studio, right-click the work item tab to copy the URL. The URL opens the work item in the web portal.
Once you've added several work items, you can use additional features to get notified of changes, create queries, define status and trend charts, plus more. To customize a work item type, see Customize your work tracking experience.