Quickstart: Add users to a project or specific team

Azure DevOps Services | 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).


If you're adding users to an Azure DevOps organization 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 topic.

Once users have been added to a project, you can browse for that name by display name as well as account name. Also, you can add them to a specific team. To add a team, see Add a team.


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.


Choose New navigation if you see a vertical sidebar or if the New Navigation feature is enabled. The vertical sidebar along with other navigational features are enabled when New Navigation has been enabled for the signed-in user or the organization. To learn how to use the web portal effectively, see Web portal navigation.

Choose Previous navigation when you see a top-level, blue-bar and when using the web portal for on-premises TFS.

  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.

    Project Settings>Security

  3. Under Groups, choose one of the following:

    • To add users who will require read-only access to the project, choose Readers.
    • To add users who will contribute fully to this project or who have been granted stakeholder access, choose Contributors.
    • For users who will 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 all other teams you add to the project are included as members of the Contributors group. So, you can choose to add a new user as a member of a team instead, and the user would automatically inherit Contributor permissions.


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

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

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

    Add users and group dialog


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

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

  8. Depending on the user, you might want to customize their permissions for other functionality in the project, such as areas and iterations or shared queries.


    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.

New navigation isn't supported on TFS at this time. Choose Previous navigation for guidance.

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 type several identities into the text box, separated by commas.

    Add users and group dialog


    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 type 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


    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.

New navigation isn't supported on TFS at this time. Choose Previous navigation for guidance.

Add users or groups to an access level

For on-premises TFS, 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 (TFS only)

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

Next steps

To view permissions for yourself or another user, see View permissions.

You can also control access to projects, version control, build, and work items.