Define iteration paths (aka sprints)
VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013
Newly created projects contain a single, root area that corresponds to the project name. Each project typically specifies a predefined set of iterations to help you get started tracking your work. All you need to do is specify the dates.
You add iteration paths under this root. To understand how the system uses area paths, see About area and iteration paths.
To create or modify areas or iterations, you must either be a member of the Project Administrators group, or your Create and order child nodes, Delete this node, and Edit this node permissions must be set to Allow for the area or iteration node that you want to modify.
If you aren't a project administrator, get added as one or have someone provide you with explicit permissions to Edit project-level information.
For naming restrictions on area and iteration paths, see About areas and iterations, Naming restrictions.
Open project settings
You define both areas and iterations from the Work hub of the project settings context.
From the web portal, open Project settings.
From the web portal for the project context, choose the gear icon..
If you're currently working from a team context, then hover over the and choose Project settings.
- Open the Work hub.
Add iterations and set iteration dates
From the Iterations page, you can add iterations that teams can then select for their use. You add iterations in the same way you add areas. For more information about working within a sprint cadence, see Schedule sprints.
You add and modify area paths from the Work, Iterations page from the project admin or settings context.
For Scrum-based projects, you'll see the following set of sprints.
To schedule the start and end dates for each sprint your teams will use, Highlight the sprint and choose Set dates. Or, you can open the context menu for the iteration path and choose Edit.
Choose the calendar icon to choose new dates.
When you're finished, you'll have a set of sprints scheduled - like this:
Your next step is to choose the sprints each team will use.
Open the Iterations tab for the project context.
For Scrum-based projects, you'll see these set of sprints.
You can change the name, location within the tree hierarchy, or set dates for any sprint. Simply open it (double-click or press Enter key) and specify the info you want.
Schedule the start and end dates for those sprints you plan to use.
After you set the start and end dates for one iteration, the calendar tool automatically attempts to set the next set of dates, based on the same iteration length you specified for the first. For example, if you set a three week sprint for Sprint 1, then when you select the start date for Sprint 2, the calendar tool automatically determines the start and end dates based on the next three weeks. You can accept or change these dates.
To add another sprint, select New child and name it what you want. Here, we call it Sprint 7.
Your next step is to select the sprints each team will use.
Rename, move, or delete an iteration
When you rename an iteration, or move the node within the tree hierarchy, the system will automatically update the work items and queries that reference the existing path or paths.
To rename an iteration path, choose the actions icon for the node, and select Edit.
In the dialog that opens, enter the new name.
To move the node within the hierarchy, change the Location field.
To delete a node, choose the Delete option from the actions menu.
When you delete an iteration node, the system automatically updates the existing work items with the node that you enter at the deletion prompt.
Chart progress by iteration
You can quickly generate queries to view the progress for those areas and iterations. As an example, you can visualize progress of work items assigned to sprints as shown in the following stacked bar chart.
As you can see, iterations play a major role in supporting Agile tools and managing work items. You can learn more about working with these fields from these topics: