Add team, go from one default team to others

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

As your organization grows, make sure that you configure your Agile tools to support that growth. Each team needs their own set of team tools to enable the autonomy it needs to manage their backlog and plan their sprints. For more information about features assigned to teams, see About teams and Agile tools.

Each new project is configured with a default team with the project name. You can rename the default team and you can reassign a new team as the default.


This article describes how to add a team or team members to a project defined in Azure DevOps. To learn about Microsoft Teams, see the Marketplace extension, Microsoft Teams Integration.

For a good understanding on how to remain Agile as you add teams, review the Scale Agile to Large Teams article.

As your team grows, you can easily move from one team to two. In this example, we add two feature teams, Email and Voice, and maintain the Fabrikam Fiber default team with visibility across each of these two teams.


  • If you don't have a project yet, create one.
  • If you're not a Project Administrator, get added as one. Only members of the Project Administrators group can add and delete teams.

Add two feature teams


To enable the user interface for the New Teams page, see Manage or enable features.

Add and configure two teams, Email and Voice. Here we show you how to add and configure the Email team.

  1. From the web portal, choose Project settings and open Teams.

    Screenshot of Open Project settings, and then Teams buttons on New Teams page

  2. Choose New team. Give the team a name, and optionally a description.

    Screenshot of New team dialog and Create team button selection on New Teams page

  3. Select the team to configure it, and then choose Iterations and areas. For more information, see Define area paths and assign to a team. See also Define iteration paths, also known as sprints, and configure team iterations.

    Screenshot of team profile, choose Iterations and areas link on New Teams page


    Team tools aren't available until the team's default area path is set. If you haven't created one or more Area Paths for the team to use, then do that now. Area Paths must be created for the project first, then assigned to the team.

    From the team profile, you can do these additional tasks:

To configure other team features, see Manage teams and configure team tools.

The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.

Add team members

When you set up a team structure for the first time, add user accounts as team members. This action provides access to the project and team assets. Moving from one team to two teams, team members already have access to the project. To support sharing code, planning, and tracking work, you must have access to the project.

Several Agile tools, like capacity planning and team alerts, and dashboard widgets are team-scoped. That is, they automatically reference the user accounts of team members to support planning activities or sending alerts.


You must first add a user to a project or to your organization or set up your account to work with Azure AD. This way you can add user identities to a team.

For more information, see Add users to a project or specific team.


The first time you add a user account, you must enter the full domain name and the alias. Afterwards, you can browse for that name by display name as well as account name. To learn more, see Set up groups for use in Azure DevOps Server deployments.

Move work items under teams

Now that your two feature teams are configured, you need to move existing work items from their current assignments to the team's default area path. This way, the work items show up on each team's backlog.

The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.

Configure the default project team

One last step in moving from one team to two teams requires configuring the default project team to exclude sub-areas.

  1. Open Project settings > Team configuration > Areas settings page for the default project team, and change the setting as shown.

    Screenshot of Default project team configuration, and Exclude work items defined in sub-area paths on the New Teams page

  2. Refresh the product backlog page for the team, and you see only those work items assigned to the Fabrikam Fiber area path.

    Screenshot of the product backlog and the default project team on the New Teams page

The New Teams user interface isn't supported for Azure DevOps Server 2020 and earlier versions.

Grant team members additional permissions

For teams to work autonomously, you may want to provide them with permissions that they don't have by default. Suggested tasks include providing team administrators or team leads permissions to:

  • Create and edit child nodes under their default area path
  • Create and edit child nodes under an existing iteration node
  • Create shared queries and folders under the Shared Queries folder

For more information on setting permissions and access for select users, see Set permissions and access for work tracking.

If your deployment is integrated with SQL Server Reports, you need to Grant permissions to view or create SQL Server reports to team members.

If your TFS deployment is integrated with a SharePoint product or SQL Server Reports, you need to manage membership for those products separately from their websites.

Next steps

Configure your Agile tools to support how your team works. Also, consider adding one or more users as team administrators. Team administrators have the necessary permissions to add team members, add a picture to the team profile, and configure and manage all team features.