Automatically merging a pull request

Enable or disable auto-merge for pull requests to streamline your workflow and automatically merge changes once all requirements are met.

Quem pode usar esse recurso?

O auto-merge para solicitações de pull está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para saber mais, confira Planos do GitHub.

Neste artigo

About auto-merge

Auto-merge merges a pull request automatically after all required reviews and status checks pass. Before you use auto-merge, it must be enabled for the repository. See Gerenciando merge automático para pull requests no seu repositório.

Auto-merge is disabled if someone without write permissions pushes new changes to the head branch or switches the base branch.

Enabling auto-merge

Observação

A opção de habilitar a mesclagem automática é mostrada apenas nas pull requests que não podem ser mescladas imediatamente. Por exemplo, quando uma regra de proteção de branch aplica "Exigir revisões de pull request antes do merge" ou "Exigir verificações de status antes do merge" e essas condições ainda não foram atendidas. Para saber mais, confira Gerenciar uma regra de proteção de ramo.

People with write permissions to a repository can enable auto-merge for a pull request.

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Pull requests.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  3. In the "Pull Requests" list, click the pull request you want to auto-merge.

  4. Optionally, select the dropdown menu, then click a merge method. See Pull request merges.

    Screenshot of the merge box of a pull request. A dropdown menu, labeled with a downward-facing triangle, is outlined in dark orange.

  5. Click Enable auto-merge.

  6. If you chose the merge or squash and merge methods, type a commit message and description.

  7. 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.

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Pull requests.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  3. In the "Pull Requests" list, click the pull request for which you want to disable auto-merge.

  4. In the merge box, click Disable auto-merge.