Auto⁠-⁠Merge

When auto_merge is enabled in your merge_protections_settings, Mergify automatically acts on pull requests as soon as all applicable merge protection success_conditions are satisfied.

The exact behavior depends on whether the merge queue is enabled for the repository:

Add auto_merge: true to the merge_protections_settings section of your Mergify configuration file:

merge_protections_settings:
  auto_merge: true

merge_protections:
  - name: require-review-and-ci
    if:
      - base = main
    success_conditions:
      - "#approved-reviews-by >= 1"
      - check-success = ci

With this configuration, any pull request targeting main that has at least one approved review and a passing ci check is automatically merged (or queued if the merge queue is enabled).

• Global setting — auto_merge applies to all pull requests in the repository. You cannot enable it selectively for specific queue rules.

• Requires merge protections — auto_merge only takes effect when at least one merge protection rule is configured. Without protection rules there are no success_conditions to evaluate.