Organize groups for your repositories

You can use user groups to provide other users access to your repositories. When you create a new repository and specify your workspace 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 changes 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 Grant repository access to users and groups for more information.

User groups have one of the following access levels:

Update existing user groups

To find your workspace's user groups, select your workspace from your profile avatar on the top navigation bar > select the Settings cog > select Workspace settings. From your settings navigation, select User groups under Access Management. You'll see a list of the existing groups. You can edit the group name, update the access provided to members of the group, add a new user, or delete users or the entire group.  

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.

1. From the User groups page, click Add group.

2. Enter a Name for your group. If the name of your group is longer than 62 characters, the slug for the group name will be truncated.

3. Click Submit to save the group.

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

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

6. 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 workspace.