Team Services | TFS 2017 | Previous versions
Feature availability: The new work item experience is currently available from Team Services and the web portal for TFS 2017. This topic describes how to track work using the new form. If you don't see the new form, your admin may need to enable it, or if it's enabled, you may need to switch to use it
If you connect to TFS 2015 or earlier versions, see Add work items to plan and track your project (TFS).
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.
Define new work
Here we show how to add work items from the web portal. Go here to learn about other supported clients.
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.
Enter a title and then save the work item. Before you can change the State from its initial default, you must save it.
Update work status
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 Closed or Done. The following image shows the work flow states for the Agile process user story. 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. If you want to permanently remove a work item, you can delete it.
With each update, the Reason field also updates and 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 support traceability
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.
There are three links controls provided on most forms. The Development and Related Work scoped links controls appear on the Details tab. The Links tab provides access to all links made to the work item.
From each links control, you can perform these actions:
- To open an associated item or object, click the linked item
- To delete a link, highlight it and click the delete icon
- To link to an existing item, or create and link a new work item, select one of the menu options.
Development scoped links control
The Development links control displays all of your development links, whether based on a git or Team Foundation version control (TFVC) repository. It displays links in a set order, and provides calls-to-action that support users to drive development from a work item.
Team Foundation version control (TFVC) lets you link work items to version control changesets or versioned source code files by using the Changeset and Versioned Item link types. When you check in pending changes or use My Work to check in changes, work items are automatically linked to your changes.
Git lets you link work items to commits by using the Commit link type. To learn how, see Manage and commit your changes.
Related scoped links control
The Related Work links control displays links to other work items in a set order on the front page of the form. It supports these link types: Duplicate/Duplicate of, Parent/Child, Predecessor/Successor, Related, and Tests/Tested by.
Links control tab
In addition, the Links control tab provides access to all links made to the work item—both work items and external objects.
Add to the discussion
Add and review comments made about the work being performed by going to the discussion section.
Click the discussion icon, which indicates how many comments have been added, to move your focus to the discussion section. Click the full screen icon to expand the display of the discussion section within the form.
Within the discussion section, you can use the @mention control to notify another team member about the discussion. Simply type @ and their name.
To reference a work item, use the #ID control. Type # and a list of work items that you've recently referenced will appear from which you can select.
For on-premises TFS, you must configure an SMTP sever in order for team members to receive notifications.
Copy the URL
From the web portal, simply copy the URL from the web browser address or hover over the title and then click the copy-to-clipboard icon.
In Visual Studio, right-click the work item tab to copy the URL. The URL opens the work item in the web portal.
Keep in mind that the work item tracking experience and forms that appear in Visual Studio won't show several of the features that the web portal makes available.
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.
Work item form controls
|Copy URL of work item to clipboard (appears on hover over work item title)|
|Go to Discussions section|
|Open Actions menu for additional work item tasks|
|Refresh work item with latest changes|
|Revert changes to work item|
|Open History tab|
|Open Links tab|
|Open Attachments tab|
|/||Enter or exit full display mode of a section within the form|
|/||Collapse or expand a section within the form|
|Add new work item and link to existing work item (May appear under Actions menu)|
|Change work item type (Appears under Actions menu)|
|Move work item to a different team project (Appears under Actions menu)|
|Copy work item and optionally change work item type (Appears under Actions menu)|
|Email work item (Appears under Actions menu)|
|Recycle work item (Appears under Actions menu)|
|Storyboard with PowerPoint (Appears under Actions menu)|
See also Keyboard shortcuts.
Plan your project
The quickest way to plan your project is to create your backlog. If you have a number of product backlog items, user stories, requirements, or tasks that you want to bulk add, you can use Excel or Project.
If you are planning a product suite and managing a portfolio of projects across several teams, you’ll want to read (New) Manage work across the enterprise.
Feature availability: The Start storyboarding menu option is only available from Team Services. However, from TFS, you can click the Start Storyboarding link from the Storyboard tabs from a backlog item, or simply open PowerPoint. See Storyboard your ideas using PowerPoint for requirements and usage.
You can storyboard your ideas using PowerPoint to bring your ideas to life with storyboard shapes, text, animation, and all the other features that PowerPoint Storyboarding provides. From any work item, you can open PowerPoint by choosing the Start storyboarding menu option.
Customize your form
You can add custom fields, modify the workflow, and change the layout of the work item form. To start, review Customize a process.
Find or list work items
Type an ID in the Search work items box and then choose the search icon.
Use the context menu to add a filter based on assignment, status, a keyword, or a work item type.
Or, using the context menu, add filters to find items based on assignment, status, a keyword, or a work item type. For example, enter A=@Me T=Task to list all tasks assigned to you. Use the =, :, and – operators to specify the operations: Equals, Contains, and Not, respectively.
Once you have a results list, you can modify the filter criteria to refine your search results.
Clients that support tracking work items
You can add work items from various clients, such as:
- From the web portal backlog pages, you can add user stories, backlog items, features, and epics from the quick add panel.
- From the Team Explorer add-in to Visual Studio, you can add most types of work items from the Work page.
- If you work in Eclipse, you can create work items using Team Explorer Everywhere.
- From Test Manager or the web portal, you can create test cases that automatically link to a user story or product backlog item.
- You can create bugs from the web portal, Visual Studio, or when testing with Test Manager.
Team context and new work items
The system automatically assigns new work items the default area and iteration paths based on the team context. Work items you add from the team dashboard (new work item widget) and queries page are assigned the team default iteration. Work items you add from a team backlog or board, are assigned the team default backlog iteration.
To learn more or to change team defaults, see Set team defaults.
Feedback and support
We welcome your feedback.
Or, see our comprehensive feedback and support page.