Add default reviewers to pull requests

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Default reviewers allow you to automatically add one or more users as reviewers to pull requests in Bitbucket Data Center. In addition, you can optionally specify how many of the specified default reviewers must approve a pull request prior to merging to ensure that a minimum level of review occurs. 

You may have different roles in your team that should be automatically added to pull requests depending on the nature of the pull request. This can be achieved by assigning default reviewers for a specific repository, a specific branch, using a branch pattern, or with a branch type from the branching model. For example, you might specify a release manager be assigned to all pull requests targeting release branches in Bitbucket.

Once assigned in the repository settings, default reviewers will be pre-filled during pull request creation. At that time the set of reviewers can then be adjusted for each pull request.

Adding default pull request reviewers for all repositories in a project

To add default reviewers for pull requests (requires project admin permissions):

  1. Go to Project settings > Default reviewers.
  2. Click Add default reviewers.
  3. For the Source branch and Target branch fields, select either Branch nameBranch patternBranching model, or Any branch.
    1. Branch name - enter the name of an existing branch.
    2. Branch pattern - use a branch permission pattern to match multiple branches.
    3. Branching model - select the branch type to restrict access to. Read more about branching models.  
    4. Any branch - add default reviewers for pull request coming from every branch (for Source branch) to any branch (for Target branch).
  4. Enter the name(s) of who should be assigned as a reviewer in the Default reviewers field. 
  5. Optional: In the Approvals required field, select how many reviewers must approve pull requests that match this criteria before merging. 
  6. Click Create.

Adding default pull request reviewers for a single repository

To add default pull request reviewers for a single repository (requires repo admin permissions):

  1. Go to Repository settingsDefault reviewers.
  2. Click Add default reviewers.
  3. For the Source branch and Target branch fields, select either Branch nameBranch patternBranching model, or Any branch.
    1. Branch name - select an existing branch by name.
    2. Branch pattern - use a branch permission pattern to match multiple branches.
    3. Branching model - select the branch type to restrict access to. Read more about branching models.  
    4. Any branch - add default reviewers for pull request coming from every branch (for Source branch) to any branch (for Target branch).
  4. Enter the name(s) of who should be assigned as a reviewer in the Default reviewers field. 
  5. Optional: In the Approvals required field, select how many reviewers must approve pull requests that match this criteria before merging. 
  6. Click Create.

Default reviewers quick add for pull request review

If default reviewers are set for the destination branch of your draft or regular pull request, they’ll be automatically added to it as reviewers. If you want feedback only from some of the added default reviewers, keep them and remove the others from the Reviewers field.

If you remove at least one default reviewer, the Default reviewers quick add button will appear under the field, showing you how many reviewers you can still add from this group.

Last modified on Feb 5, 2024

Was this helpful?

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