Grant access to a workspace

You can see all of your workspace's repositories from your workspace's Repositories page. To find a workspace, go to your avatar in the bottom left and click All workspaces. When you create repositories in your workspace, you can also organize them by project.

Add a member to your workspace

Once you've created a workspace, you can start adding other users as members.

  1. From your avatar, select the workspace or select All workspaces for a full list.

  2. Click Settings in the left sidebar, and then select User groups under the Access Management heading.

  3. Select the Add members button.

  4. Enter an email address in the field provided.
    Note: Entering the email address of a non-Bitbucket user sends an invitation to that person to create a Bitbucket account and join the workspace. You can add up to 10 people at a time.

  5. Select the User groups field to display a list of existing groups in your workspace. Select the group that you want to add the member to, if necessary.

  6. Click Confirm.

  7. Repeat the last two steps for each user you want to add.

If you entered an email address and it has a corresponding Bitbucket account, the system resolves the account for you. If Bitbucket couldn't resolve the address, it sends the user an invitation to join the workspace by creating a Bitbucket account.

Add a group to your workspace

  1. From your avatar in the bottom left, select the workspace or click All workspaces for a full list.

  2. Click Settings in the left sidebar, and then select User groups under the Access Management heading.

  3. Select the Create group button.

  4. Enter a name for the group.

  5. Select the Workspace permissions for the new group.

  6. From the Default repository access dropdown, select the repository access you would like to grant members in this group. Note: This is the access granted to members for any repositories added after creating the new group. To grant members access to an existing repository, use the steps below in the Grant access to workspace repositories section.

  7. Select Confirm.

Grant access to workspace repositories

You can control access to your workspace's repositories by adding specific user groups or individual users to your workspace. To create a group, go to Settings > User groups.

If a user deletes his or her account, Bitbucket automatically deletes that user from all repository access lists.

New group access on existing repositories

If you create a new group for your workspace, it doesn't get automatically added to your existing repositories. To grant the new group access to existing repositories in your workspace:

  1. Open Settings and select User groups.

  2. Under Group name, select the user group you want to add repositories to. 

  3. Select the Repositories tab.

  4. To edit the permissions per repository, select the appropriate dropdown in the Permissions column and select the permission level to assign to the repository.

  5. Bulk permissions: To update more than one repositories permissions, select the checkbox associated with each repository > select the Edit permissions button > select the level of permissions from the Select permission dropdown > select Confirm.

  • Admin–Allows users to do everything a repository owner can do: change repository settings, update user permissions, and delete the repository.

  • Write–Allows users to contribute to the repository by pushing changes directly.

  • Read–Allows users to view, clone, and fork the repository code but not push changes. Read access also allows users to create issues, comment on issues, and edit wiki pages.

Group access on future repositories

When you create a repository in a workspace with existing user groups, Bitbucket determines if the workspace has any groups with the Default Access permissions of ReadWrite, or Admin. If it does, Bitbucket adds those groups to the new repository with the default permission. If you specify None for the default permissions, Bitbucket ignores that group and doesn't add it.

User groups are the best way to manage access to your workspace's repositories. However, for special circumstances, you can also add users individually to repositories.

User access on existing repositories

If you want to add individual users to your workspace's repository, do the following:

  1. Click Repository settings in the left sidebar navigation of the Bitbucket repository.

  2. Click User and group access on the left sidebar navigation.

  3. Select the Add members button.

  4. Enter the Bitbucket user's name or email address in the text box. You can add up to 10 users at a time.

  5. Select a permission from the dropdown menu.

  6. Select Confirm.

If the team member doesn't have a Bitbucket account, then Bitbucket prompts him or her to create one. Once the person has an account, Bitbucket adds the account to the repository with the access you chose when you created the invitation.

Display all the members of a workspace

If you would like to see all the members that belong to a workspace, go to the User directory where you can also view member's access at the workspace level or across specific repositories.

  • To view a member’s access, select View access under Actions.

    • The View access dialog lists the groups that a user is part of and the repositories in which the user has direct access. Note: It does not display the repositories that the user has access to within any groups.

    • Select Remove to remove a member’s direct access to a repository.

  • Use the Search bar to search for a specific user or group in the workspace.

  • Select a repository from the Repositories filter dropdown or type a repository name to filter the list by a specific repository.

Update your plan details

If your Bitbucket account containing this workspace is on the Free plan, you have a team limit of 5 users. If the number of users with access to your workspace's repositories goes over 5 users, access becomes read-only for all your private repositories. The repository admins still have write access to each repository, and administrators can still administer each repository.

To restore access, remove excess users from the repository or upgrade your plan. For more information, see Plans and billing.

Additional Help