Managing auto-merge for pull requests in your repository

You can allow or disallow auto-merge for pull requests in your repository.

People with maintainer permissions can manage auto-merge for pull requests in a repository.

Auto-merge for pull requests is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub's products."

About auto-merge

If you allow auto-merge for pull requests in your repository, people with write permissions can configure individual pull requests in the repository to merge automatically when all merge requirements are met. If someone who does not have write permissions pushes changes to a pull request that has auto-merge enabled, auto-merge will be disabled for that pull request. For more information, see "Automatically merging a pull request."

Managing auto-merge

Note: the option to enable auto-merge is shown only on pull requests that cannot be merged immediately. For example, when a branch protection rule enforces "Require pull request reviews before merging" or "Require status checks to pass before merging" and these conditions are not yet met. For more information, see "Managing a branch protection rule."

  1. On, navigate to the main page of the repository.
  2. Under your repository name, click Settings. Repository settings button
  3. Under "Merge button", select or deselect Allow auto-merge. Checkbox to allow or disallow auto-merge

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.