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 under 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 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 Add member button or select a group where you want to add a user or users.

  4. Enter an email address in the field provided.
    Entering the email address of a non-Bitbucket user sends an invitation to that person to create a Bitbucket account and join the workspace.

  5. Select the 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 Add group button.

  4. Enter a name for the group.

  5. 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.

  6. Select the Workspace permissions for the new group.

  7. Select the Admin notifications checkbox, if you would like the new group to receive notifications.

  8. Select Add.


Grant access to workspace repositories

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

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 Repository settings and click User and group access.

  2. Under Groups, click Select a group and scroll down to your new group.

  3. After you've found the right group, pick the access level from the next dropdown:

    • 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.

  4. Click Add to add the group to the repository.

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.

To update the group permissions for only one repository, you can do so from the User and group access page of the repository settings.

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. Locate the Users section of the page for a current list of users with access.

  4. Enter the Bitbucket user's name or email address in the text box.

  5. Select a permission from the dropdown menu.

  6. Click Add.

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.

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.

Last modified on Dec 10, 2020
Cached at 3:47 PM on Apr 14, 2021 |

Additional Help

Ask the Community