Get started with Bitbucket Cloud
New to Bitbucket Cloud? Check out our get started guides for new users.
Configure project permissions for users and groups
Project permissions allows admins to grant access to all repositories, old and new, within a project without having to manage each repository individually, meaning any permissions set within a project will apply to all the repositories in that project.
Projects have four hierarchical levels of permissions: Admin, Create, Write, Read. Each permission in the hierarchy includes all permissions below it. For example, ‘Admin’ includes ‘Create, Write, and Read’ and ‘Create’ includes ‘Write and Read’.
Admin - grants full administrative control of the project and the repositories within. Admins can make any changes to project or repositories settings and permissions. For existing projects, the current workspace admins will assume the role of project admin but they can now delegate this responsibility to others.
Create - grants permission to allow users to create repositories within the project and provides write access to all repositories in that project.
Write - grants permission to allow users can access, edit, and create content on any repositories in the project.
Read - grants permissions providing users with exactly that, only the ability to read the content within any repositories.
Repository administration and project permissions
If you are a repository admin, you will see project permissions that are applied across all the repositories in the project, but you will not be able to edit them. These permissions are inherited from the project.
Access and create project permissions
Make sure you are in the project where you would like to create or administrate permissions across all the repositories within that project. If you are not in the proper project, select the Projects tab on the top navigation bar to display a list of projects within the current workspace.
Select Project settings on the left sidebar.
Select Project permissions under the General heading on left sidebar.
Select Add users or groups to add a user to a current group or to add a group to the project and assign them permissions within the project.
Enter the group or user by name or enter the user’s email address, if they are not already a member of the workspace.
Select the permissions dropdown (currently displaying Read, by default) and select the permission you want to set for this group or user.
Select Confirm to save your updates.
Update or edit project permissions
Make sure you are in the project where you would like to create or administrate permissions across all the repositories within that project. If you are not in the proper project, select the Projects tab on the top navigation bar to display a list of projects within the current workspace.
Select Project settings on the left sidebar.
Select Project permissions under the General heading on left sidebar.
Select the Permission dropdown associated with the user or group in the project.
Select the permission (Read, Write, Create, or Admin) from the dropdown menu to update the user or group’s permission in this project.
Update multiple groups or users project permissions
You can also update project permissions in bulk.
Select Project settings on the left sidebar.
Select Project permissions under the General heading on left sidebar.
Select the checkboxes associated with the projects you want to update.
Select the Edit permissions button above the list of projects.
Select the Select permission dropdown in the Edit permissions dialog to display a list of available project permissions.
Select the permission you want to assign to the groups and/or users you’ve selected.
Select Confirm to assign the updated permissions to these groups and/or users.
Filter and search for users or groups
To search for a specific user or group within a project, select the Search bar above the list of users and groups and enter the name of a user or group.
To filter users and groups by a specific permission, select the Permissions dropdown to the right of the Search bar and select the permission of the users and groups you would like to display.
To filter the list of users and groups by the level of access they have in Bitbucket Cloud, select the Access level dropdown to the right of the Permissions dropdown and select the level of access you want to filter your results by. This can be helpful to know where a group or user is being administrated from within Bitbucket Cloud.
Remove a user or group’s access to a project
There may be times when you need to remove a user or group’s access to a project.
Make sure you are in the project where you would like to create or administrate permissions across all the repositories within that project. If you are not in the proper project, select the Projects tab on the top navigation bar to display a list of projects within the current workspace.
Select Project settings on the left sidebar.
Select Project permissions under the General heading on left sidebar.
In the Actions column, select Remove associated with the user or group whose access you would like to remove.
Select the Remove button in the Remove access dialog to remove the user or group’s access from the project.
Remove multiple groups or users project permissions
You can also remove project permissions in bulk.
Select Project settings on the left sidebar.
Select Project permissions under the General heading on left sidebar.
Select the checkboxes associated with the projects you want to update.
Select the Remove button above the list of projects.
Select Confirm to remove these groups and/or users from the project.
Removing a user or group from a project does not remove them from the workspace and also does not remove permissions they have been assigned within the workspace or any repositories, individually.
If you need to add users to a group or add groups to your project, refer to the ‘Configure project settings’ support documentation.
Was this helpful?