Skip to main content

Default reviewers

By configuring default reviewers, you ensure that the specified people are automatically added as reviewers to all the new pull requests that match the defined source and target branches. You can also define how many of the default reviewers must approve a pull request before it can be merged into the target branch.

Note:

Access to this feature is limited to users who already have access to CI Manager.

Default configuration​

By default, there are no reviewers or required approvals configured for your repositories. This configuration is defined on the star system level and, by default, inherited by each repository. You can create a different custom configuration for each repository in your project.

Note:

You can't modify a project level configuration.

Manage configuration​

To manage default reviewers:

  1. Select a star system.

  2. From Apps, select Repository Settings or select it from your pinned apps.

  3. Select the Default reviewers tab.

You can also manage default reviewers with the Repository Settings API.

Add default reviewers​

To configure default reviewers:

  1. In the Default reviewers tab, select + Add reviewers.

    You can also select + Add reviewers next to the repository whose settings you want to change. Then in the dropdown, you can see the pre-selected repository.

  2. From the Repository dropdown, select a repository.

  3. Specify the source and target branches. You have the following options:

    • Any branch

      Applies to all branches.

    • Branch name

      Applies only to a branch with the specified name. The branch must be active.

    • Branch pattern

      Applies to every branch whose name matches the pattern. For details, see Branch patterns.

    • Branch type

      Possible types are Development, Production, Bugfix, Feature, Hotfix, or Release. The available values depend on your branch configuration.

      You can modify the branch configuration with the Repository Settings API.

  4. In Default reviewers, specify at least one user.

    Users must have a Bitbucket account and access rights to the star system that includes the selected repository.

  5. Specify the number of required approvals.

  6. Select Add.

Edit default reviewers​

To edit default reviewers:

  1. In the Default reviewers tab, expand the configuration for a selected repository.

    For Jutro apps and Integration apps, select a repository from a drop-down list.

  2. Select Edit next to an element that you want to modify.

Note that you can only edit the defined users and a number of required approvals. You can't edit a source or a target branch.

Delete default reviewers​

To delete default reviewers:

  1. In the Default reviewers tab, expand the configuration for a selected repository.

    For Jutro apps and Integration apps, select a repository from a drop-down list.

  2. Select Delete next to an element that you want to delete.

    The deleted element is now crossed out.

Troubleshooting​

Here are the most common issues related to default reviewers:

  • A user doesn't show in the drop-down lists.

    Verify if the user has a Bitbucket account and access rights to the star system. If they do and you still can't see them, it might be a propagation issue. To fix it, the user must first log in to Bitbucket.

  • The Edit button is disabled when editing default reviewers and I can't save my changes.

    Remove all inactive and deleted users from your configuration.