About auto-merge
If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks.
Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "Managing auto-merge for pull requests in your repository."
You can provide feedback about auto-merge by contacting us.
Enabling auto-merge
People with write permissions to a repository can enable auto-merge for a pull request.
- On GitHub, navigate to the main page of the repository.
- Under your repository name, click Pull requests.
- In the "Pull Requests" list, click the pull request you'd like to auto-merge.
- Optionally, to choose a merge method, select the Enable auto-merge drop-down menu, then click a merge method. For more information, see "About pull request merges."
- Click Enable auto-merge.
- If you chose the merge or squash and merge methods, type a commit message and description and choose the email address you want to author the merge commit.
- Click Confirm auto-merge.
Disabling auto-merge
People with write permissions to a repository and pull request authors can disable auto-merge for a pull request.
- On GitHub, navigate to the main page of the repository.
- Under your repository name, click Pull requests.
- In the "Pull Requests" list, click the pull request you'd like to disable auto-merge for.
- In the merge box, click Disable auto-merge.
