Jaa


Add users or groups to a team or project

TFS 2017 | TFS 2015 | TFS 2013

You add users to a team or project so they can contribute to the team and project. For enterprise organizations with large user bases, we recommend you use Active Directory or Windows Group to manage users through security groups. However, to enable flexibility for all size organizations, the following operations are supported:

  • Team and project administrators can add existing users to their team or project. Existing users are ones known to the project collection through Active Directory or Windows group.
  • Adding users to a team or project automatically adds them to the Contributors group for the project. Members of the Contributors group have permissions to most features needed to contribute.
  • By adding users to a team, you make team-specific tools aware of them, such as the team security group, Team Members widget, and sprint capacity planning tools.
  • Once users have been added to a project or organization, you can browse for their display name or user name (email alias) from any people-picker tool.

You add projects to an organization or project collection and you add teams to projects. To learn more, see:

Important

Select a version from TFS Content Version selector.

To view the content available for your platform, make sure that you select the correct version of this article from the version selector which is located above the table of contents. Feature support differs depending on the on-premises version of TFS you are using. .
To learn which on-premises version you are using, see What platform/version am I using?

Supported options for adding users

Team and project administrators can add existing users to their team or project. Existing users are ones that are known to a project collection through the Active Directory or Windows Group created for the server that hosts the on-premises Azure DevOps Server.

Administrator level

Interface

Supported tasks

Team administrators

Add existing users or groups to a team, or remove a member.

Project Administrators

Add existing users or groups to a security group. By adding to a team group, you effectively add them to the team. Optionally remove a user from a group.

Active Directory Administrators

Active Directory or Windows Group

Users you add to Active Directory or Windows Group connected to Azure DevOps are added as members of the Project Collection Valid Users group. They have access to all projects within a project collection. To learn more, see Set up groups for use in Azure DevOps on-premises.

Prerequisites

If you're new to Azure DevOps, you may want to familiarize yourself with the information provided in these articles:

Add users or groups to a team

Add existing users or security groups to a team from the Project settings> Teams page. From this interface you can view, add, or remove users and security groups to/from a team. To add a custom security group, see Add or remove users or groups, manage security groups.

Choose the Current page tab for information on adding a user to a team. The New Teams Page preview feature is only available for Azure DevOps Services at this time.

Remove users or groups from a team

From the team's Members page, you can remove members.

Choose the Current page tab for information on adding a user to a team. The New Teams Page preview feature is only available for Azure DevOps Services at this time.

Note

For on-premises Azure DevOps, all email actions require an SMTP server to be configured.

Add users or groups to a project

As a member of the Project Administrators group, you can add users or groups to a project from the Project settings> Permissions page by adding them to a security group. To add a custom security group, see Add or remove users or groups, manage security groups.

Choose the Current page tab for information on adding a user to a project. The Project Permissions Settings Page preview feature is only available for Azure DevOps Services at this time.

Add users or groups to an access level

For on-premises deployments, you may need to set the access level for a user or group, particularly if those groups don't belong to the default access level. To learn more, see Change access levels.

Add users or groups to SharePoint or SQL Server Reports

If your on-premises 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