Define iteration paths (aka sprints)

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

Newly created team projects contain a single, root area that corresponds to the team project name. Team projects typically specify 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.

Prerequisites

  • You must be a member of a team project. If you don't have a team project yet, create one in VSTS. If you haven't been added as a team member, get added now.
  • You must be a member of a team project. If you don't have a team project yet, create one in an on-premises TFS. If you haven't been added as a team member, get added now.
  • 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 the administration context for the team project

From the web portal, open the admin page for the team project.

You define both areas and iterations from the Work hub of the team project admin context. From the user context, you open the admin context by clicking the gear icon. The tabs and pages available differ depending on which admin context you access.

  1. From the web portal for the team project context, click the gear icon..

    Web portal, VSTS, Open Admin context, team project level If you're currently working from a team context, then hover over the gear icon and choose Project settings.

    Default Collection Overview, Projects reference processes

    TFS 2017.1
    Web portal, TFS 2017.1, Open Admin context, team project level TFS 2017
    Web portal, TFS 2017, Open Admin context, team project level

  2. Open the Work hub.

  1. From the web portal user context, click the gear icon gear Settings.

    Open the project administration page

  2. Open the Iterations tab.

Add iterations and set iteration dates

From the Iterations page, you can add and select the iterations that will be active for your team. You add iterations in the same way you add areas. For more information about working within a sprint cadence, see Schedule sprints.

  1. Open the Work, Iterations page for the team project context.

    For Scrum-based team projects, you'll see these set of sprints.

    Work, Iterations page, VSTS platform

    If you need to select another team project, go to the Overview page for the collection (click the DefaultCollection link).

  2. Schedule the start and end dates for each sprint your teams will use. Click Set dates or choose to edit the iteration from the Actions icon actions menu for the sprint.

    Edit iteration, schedule start date, VSTS platform

  3. When you're finished, you'll have a set of sprints scheduled - like this:

    Work, Iterations page, scheduled set of sprints, VSTS platform

    Your next step is to choose the sprints each team will use.

  1. Open the Iterations tab for the team project context.

    For Scrum-based team projects, you'll see these set of sprints.

    Example Iterations for a Team

    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.

  2. Schedule the start and end dates for those sprints you plan to use.

    Define start and end dates for a sprint

    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.

  3. To add another sprint, select New child and name it what you want. Here, we call it Sprint 7.

    Iterations, defaults defined for Agile

    Your next step is to select the sprints each team will use.

Rename 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.

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 area or iteration

You can quickly generate queries to view the progress based on an iteration. As an example, you can visualize progress of work items assigned to sprints as shown in the following stacked bar chart.

Stacked bar chart by area

As you can see, areas and 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: