ContextQMD
Back to Gitlabhq

Automatic reviewer assignment

doc/user/project/merge_requests/reviews/automatic_reviewer_assignment.md

19.1.02.7 KB
Original Source

{{< details >}}

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

{{< /history >}}

When you enable automatic reviewer assignment, GitLab assigns the Code Owners of changed files as reviewers on a merge request. You don't have to select reviewers from the CODEOWNERS file by hand.

Prerequisites

  • The project must have a CODEOWNERS file.
  • The Maintainer or Owner role for the project.

Enable automatic reviewer assignment

To turn on automatic reviewer assignment for a project:

  1. In the left sidebar, select Search or go to and find your project.
  2. Select Settings > Merge requests.
  3. Go to the Automatic reviewer assignment section.
  4. Select Automatically assign all code owners as reviewers.
  5. Select Save changes.

When GitLab assigns reviewers

After you turn on the setting, GitLab assigns Code Owners as reviewers when:

  • A merge request is created in a ready state.
  • A draft merge request is marked as ready.

GitLab assigns every Code Owner that matches the files changed in the merge request.

GitLab skips auto-assignment when:

  • The merge request is a draft.
  • The merge request already has a reviewer. @GitLabDuo is excluded from this check.
  • No code owner matches the files changed in the merge request.
  • The merge request author does not have permission to set merge request metadata.

Reviewer assignment strategy

In projects where GitLab Duo Agent Platform recommends reviewers, the Automatic reviewer assignment section shows a Reviewer assignment strategy with these options:

  • Do not assign reviewers automatically: GitLab does not change the reviewers.
  • Assign all code owners as reviewers: GitLab assigns every Code Owner from the CODEOWNERS file that matches the changed files.
  • Assign reviewers with GitLab Duo Agent Platform: GitLab Duo Agent Platform recommends the minimum number of reviewers required to satisfy each approval rule.