Grant users and groups access

On this page

Redirection notice

This page will redirect to /bitbucket/set-permissions-for-forking-and-repository-access-221449716.html .

Repository administrators can grant users or groups access to a repository using the User and group access page.  Administrators can assign a user or a group any of the following default permissions:

Level This permissions allows a user to do the following:
read View, clone, and fork the repository code. All public repositories grant all Bitbucket Cloud users read permissions automatically. Read access on a repository also allows users to create issues, comment on issues, and edit wiki pages.
write Contribute to the repository by pushing changes directly from a repository on a local machine.
admin Can do everything a repository owner can do. This means administrators can:
  • Change repository settings.
  • Add, change, and remove user permissions.
  • Give other users administrator access.
  • Delete the repository.

You can always change these permissions later.

Granting a User Access to a Repository

To grant a user access to the repository, do the following:

  1. Go to the Settings for the Bitbucket repository.
  2. Click User and group access on the left navigation.
  3. From the Users section, enter a user's email address or username in the text box.
  4. Select a permission from the dropdown box.
  5. Click Add.

Can I add a Team?

You cannot add a team to your repository directly. You can either Change or transfer repository ownership or create a new group and add the specific users you want to that group.

Sending an Invitation

If you want to grant access to a person who does not have a Bitbucket account, you can send an invitation. To do this from the User and group access page:

  1. From the Users section, enter the email address of the user you'd like to invite.
  2. Select what type of Access to grant.
  3. Press Add.
    Bitbucket sends an email to the addressee with an email to contribute to your repo.
    If the addressee does not have an Atlassian account, Bitbucket prompts him or her to create one.  Once the addressee has an account, Bitbucket adds the account to the repository with the access you chose when you created the invitation.

To change or delete a user's access

Each user entry on the list has controls for changing a user's level of access and for removing the user all together:

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

Granting a Group Access to a Repository

You can only add groups to a repository if you own the group (individual account) or administer the group for a team.  Groups consist of one or more members all of which must have a Bitbucket individual account. To add groups, you go to the Account page for an  individual or team account.

  1. Go to a repository for which you have administrative rights (or create a new one).
  2. Click Settings in the sidebar.
  3. Choose User and group access from the left navigation.
  4. Add a group from the Select a group drop down.
    The list contains all the groups you have access to either through your individual account or through a team.

Changing Group Permissions 

Bitbucket allows account administrators to grant access to repositories by adding Groups. When a repository is added to the account, Bitbucket automatically adds any account-level groups that have repository permissions. This means the groups that appear on repository's User and group access page may come via the account-level Groups or directly by adding them at the repository-level. 

When a group is added to a repository, either automatically by Bitbucket or manually by a repository administrator, the group has the default permissions defined at the account-level. Repository administrator's can change group permissions at the repository level or they can remove the group all-together; These are called repository-level permissions.   Once you establish repository-level permissions for a group, these repository-level permissions remain in effect, no matter if account administrators later change the permissions on the account-level.

If account administrators remove a group, the group is removed from every repository to which it has access.  For more information on creating and removing groups, see Organize groups for your repositories.

How Repository Access Impact Plans and Billing 

What happens when the maximum number of users for an account is exceeded because you have granted repository permissions to a group? If the user count goes over the plan limit for your account, then access becomes read only for all your private repositories. The repository owner and creator still has write access to each repository, and administrators can still administer the repository.

Account owners or repository administrator remove excess users and groups from the account or from its repositories. For more information, see Bitbucket Cloud plan details.

Last modified on Jun 19, 2017

Was this helpful?

Provide feedback about this article

Not finding the help you need?

Ask the community

Powered by Confluence and Scroll Viewport.