Organize groups for your repositories
You can use user groups from your individual account to provide other users access to your repositories. When you create a new repository and specify your individual account as the owner, Bitbucket adds your existing user groups (unless they have a no access level) to the repository. If you change your user group from no access to another access level, Bitbucket adds that user group to the repositories you own.
If you update a group from a repository, those change won't impact the group overall. In addition, any changes you make to the group from your User groups page won't impact your repository settings. See Set permissions for forking and repository access for more information.
User groups have one of the following access levels:
|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.|
|None||Prevents those users from seeing anything in the repository.|
Update existing user groups
To find your team's user groups, select your team from your avatar in the bottom left and click Bitbucket settings. From your settings navigation, select User groups. You'll see a list of the existing groups, similar to the following example.
- Add group: Creates a new group for your individual account.
- Edit group: Click Edit to update the name of the group.
- Add user: Enter the username or email address, and then click Add.
- Delete group: Removes the group from Bitbucket.
- Delete user: Removes the user from the group.
- Edit access: Update the group's repository access level.
When you delete a group
That group no longer has access to any repositories it previously had. As a result, all group members lose access too unless they're part of another group with access.
When you update a group's repository access
You change the group access for future and existing repositories. If you already removed that group from a repository your own, changing a group's access has no impact on that repository.
Create a new user group
When you create a group, you specify the type of repository access you want to give group members for repositories.
- From the User groups page, click Add group.
- Enter a Name for your group.
- Click Submit to save the group.
- Select the repository access for the group:
- 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.
- no–Prevents those users from seeing anything in the repository.
- When you change the access level for a group, you automatically update all repositories with that group to the new access. As a result, you'll get a confirmation dialog to confirm that you want to update all your repositories. Click Confirm to continue.
- Add users to your group by entering usernames or email addresses and clicking Add. If you add a member via email, Bitbucket sends an email inviting them to join your team.