Grant repository access to users and groups

When you create a repository, you specify whether it's private or public. If your repository is public, anyone can access it. If your repository is private, you can grant access to individuals and groups of users.

To create groups, go to the User Groups page of your Workspace settings.

Users and groups have one of the following access levels:

Admin

Allows users to do everything within the repository: 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.

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

Adding users and your Bitbucket Cloud plan

If you're on the Free plan and the number of users with access to your private repositories goes over 5, access becomes read-only until you upgrade your account or remove users from a group or individual repositories. You and other repository administrators still have access to the repository. For information on plan limits, see Bitbucket Cloud plan details.


Can I add a workspace?

You can't add a workspace to your repository. The only workspace with access is the workspace that owns the repository, but you can transfer repositories to your workspace if necessary. Or create a new group and add the specific users you want to that group.


Update user or group access for a repository

To update group access on a repository, select the repository > select Repository settings > select Repository permissions > select the new permission level you want to grant to the group for this repository from the Permission dropdown. Note: You can only update the permissions for groups or users that are only provided access to the repository.

When you change group access or remove a group from a repository, you establish repository-level group settings. These changes remain in effect for the specific repository, even if you later change the group's access from the account or workspace's User groups page.

Add repository permissions to multiple users or groups

To update more than one group or user’s access to a repository, select the repository > select Repository settings > select Repository permissions >select the checkbox next to the groups or users you want to update > select the Edit permissions button > select the new permission level you want to grant to the group for this repository from the Select permission dropdown.

Add user access to a repository

While user groups are the best way to manage access to your repositories, you can also add users individually. To add individual users to your repository:

  1. Select Workspace settings from your Settings dropdown.

  2. From the User groups page, select Add members.

  3. Enter the user by name or email address, if they are not already a member of the workspace.

  4. Select an access level from the dropdown menu.

  5. Select Confirm.
    If you add the email address of someone without an account, that person receives an email prompting him or her to create one. Once the user has Bitbucket access, he or she can access the repository.

For more information about how to grant access and configure permissions within a project, refer to Configure project permissions for users and groups.

Additional Help