Using repository permissions

Still need help?

The Atlassian Community is here for you.

Ask the community

Bitbucket Server allows you to manage the permissions for just a single repository, or for a group of repositories together from the project.

Repository permissions allow you to extend access to a repository, for those who don't have project permissions. For example, you might use repository permissions to allow external developers or consultants access to a repository for special tasks or responsibilities.

Bitbucket Server supports 3 levels of permissions for repositories: 

  • Admin
  • Write
  • Read

Depending on the permission level for the repository that has been granted to you, you can perform different actions in the repository:


Clone, fork, pull
Create, browse or comment on a pull request
Merge a pull request
Edit settings and permissions



(tick) (tick) (tick) (tick)



(tick) (tick)





(tick) (error) (error) (error)

Note that:

  • Anyone with permission to browse a pull request can create a task on any comment, and can browse, resolve and reopen existing tasks in the pull request.
  • Repository admins and pull request authors can edit and delete any task in the pull request. Reviewers and others can only edit or delete their own tasks.

Granting access to a repository

To modify it's permissions, go to the repository's settings and click on Repository (under 'Permissions'). Click in the  Add Users  or  Add Groups  field in the relevant section to search for, and bulk add, users or groups. Now choose a permission from the list and click Add.

Once added, you can use the checkboxes to edit specific permissions for an individual user or a particular group.

Granting access to all repositories within a project

If you have a large number of repositories in a project, project level permissions provide a  convenient  way to grant access to  all  repositories within that project. For example you can grant a group, say "Team A",  Write  access at the project level, which will  automatically  give them Write access to all existing repositories in the project, as well as any repositories that are subsequently created in the project.

To modify permissions for a project, click the Permissions tab when viewing the project. You can add, or modify, permissions for individual users, and groups, in the same way as described above for a single repository.

Granting permission to create repositories

Only users with project administration permission can create new repositories.  

Last modified on Sep 16, 2015

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.