Add users to a project or team

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

In this quickstart, you learn how to add users to a project or specific team. For anyone to access a project, they must be added to one of the default security groups or a custom group. Usually you add them to the Contributors group. For a quick look at what permissions are assigned to the default groups, see Permissions and access.

The easiest way to add a number of users to a project is to add groups defined in Azure Active Directory (Azure AD) or Active Directory (AD).

Important

If you're adding users to an organization in Azure DevOps and you don't use Azure AD, then you need to add their "personal" Microsoft accounts to your account or project. After you've added them to one project, you can add them to additional projects using the procedures provided in this article.

Once users have been added to a project, you can browse for their display name or user name (email alias). Also, you can add them to a specific team. To add a team, see Add a team.

Prerequisites

Add users to a project

If you are adding a user to Azure DevOps for the first time, see Add account users for Azure DevOps.

  1. Open the web portal and choose the project where you want to add users or groups. To choose another project, see Switch project, repository, team.

  2. Choose Project Settings and then Security.

    To see the full image, click to expand.

    Project Settings>Security

  3. Under Groups, choose one of the following options:

    • To add users who require read-only access to the project, choose Readers.
    • To add users who contribute fully to this project or who have been granted Stakeholder access, choose Contributors.
    • For users who need to administrate the project, choose Project Administrators. To learn more, see Set permissions at the project-level or project collection-level.
  4. Next, choose the Members tab.

    Here we choose the Contributors group.

    Security page, Contributors group, Membership page

    By default, the default team group and any other teams you add to the project, are included as members of the Contributors group. Add a new user as a member of a team instead, and the user automatically inherits Contributor permissions.

    Tip

    Managing users is much easier using groups, not individual users.

  5. Choose gear iconAdd to add a user or a user group.

  6. Enter the name of the user account into the text box. You can enter several identities into the text box, separated by commas. The system automatically searches for matches. choose the match(es) that meet your requirements.

    Add users and group dialog

    Note

    The first time you add a user or group to Azure DevOps, you can't browse to it or check the friendly name. After the identity has been added, you can just enter the friendly name.

  7. In Identities, specify the name of the user or group you want to add.

  8. Depending on the user, you may customize their permissions for other functionality in the project. For example, in areas and iterations or shared queries.

    Note

    Users that have limited access, such as Stakeholders, won't be able to access select features even if granted permissions to those features. To learn more, see Permissions and access.

  1. Open the web portal and choose the project where you want to add users or groups. To choose another project, see Switch project, repository, team.

  2. Choose the  gear icon to open the administrative context.

    Open Project Settings, horizontal nav

  3. Choose Security and under Groups, choose one of the following options:

  4. Next, choose the Members tab.

    Here we choose the Contributors group.

    Security page, Contributors group, Membership page

    Tip

    Managing users is much easier using groups, not individual users.

    By default, the default team group and any other teams you add to the project, are included as members of the Contributors group. Add a new user as a member of a team instead, and the user automatically inherits Contributor permissions.

  5. Choose gear iconAdd to add a user or a user group.

  6. Enter the name of the user account into the text box. You can enter several identities into the text box, separated by commas. The system automatically searches for matches.

    Add users and group dialog

    Note

    The first time you add a user or group to Azure DevOps, you can't browse to it or check the friendly name. After the identity has been added, you can just enter the friendly name.

  7. In Identities, specify the name of the user or group you want to add.

  8. You may want to customize user permissions for other functionality within the project, such as areas and iterations or shared queries.

    Note

    Users that have limited access, such as Stakeholders, won't be able to access select features even if granted permissions to those features. To learn more, see Permissions and access.

Add users to a team

Several Agile tools, like capacity planning, team alerts, and dashboard widgets are team-scoped. That is, they automatically reference the user accounts added as members of a team to support planning activities or sending alerts. To learn more, see About teams and Agile tools.

You add team members from Project Settings>Work>Team configuration. You can quickly navigate to it from a team work tracking backlog, board, or dashboard.

  1. Open a backlog or board for a team and choose the  team profile icon. Then choose Team Settings.

    Here we open the Board for the Web team and from there the team profile.

    Work Backlog or Board, choose team profile icon

  2. If you need to switch the team context, use the team selector within the breadcrumbs.

    Team Configuration, Team breadcrumb

  3. Choose Add.

    Team Profile, choose Add

  4. Enter the sign-in addresses or display name for each account you want to add. Add them one at a time or all at the same time. You can enter several identities into the text box, separated by commas.

    Add users and group dialog

    Tip

    You must enter user and group names one at a time. However, after entering a name, the account is added to the list, and you can enter another name in the Identities text box before choosing to save your changes.

    You may need to choose the  refresh icon to see your updates.

  5. To remove members, return to this page, highlight the user name and choose Remove.

    Team profile page, remove a team member, new nav

    Note

    To remove a team administrator as a team member, you must first remove them as an administrator.

  6. To add an account as a team administrator, choose Add located in the Team Profile page. For details, see Add a team administrator.

  1. From the project admin context, open the Overview page, and then choose the team you want to add team members to.

    Project Settings, Overview page, Choose team

  2. Choose the plus iconAdd to add a user or a user group.

  3. Enter the sign-in addresses or display name for each user you want to add. Add them one at a time or all at the same time. You can enter several identities into the text box, separated by commas.

    Add users and group dialog

    Tip

    You must enter user and group names one at a time. However, after entering a name, it is added to the list, and you can enter another name in the Identities text box before choosing to save your changes.

    You may need to choose the  refresh icon to see your updates.

  4. To remove members, return to this page, highlight the user name, and then choose Remove.

    Team profile page, remove a team member

    Note

    To remove a team administrator as a team member, you must first remove them as an administrator.

  5. To add an account as a team administrator, choose Add located in the Team Profile page. For details, see Add a team administrator.

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 SQL Server Reports

If your on-premises deployment is integrated with SQL Server Reports, you need to manage membership for those products separately from their websites. See Grant permissions to view or create SQL Server reports in Azure DevOps.

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