update

The update action updates the pull request against its base branch. It works by merging the base branch into the head branch of the pull request.

Tip

You do not need to use this action if you use the queue action. The merge queue automatically update the pull requests it processes as necessary, making sure they are test with up-to-date code before being merged.

Options

Key Name	Value Type	Default	Value Description
bot_account	Template		Premium Plan Feature 🦾 Mergify can impersonate a GitHub user to update a pull request. If no bot_account is set, Mergify will update the pull request itself.

Examples

↑ Linear History

As GitHub supports linear history in pull request settings, it is very handy to use a rule to keep your pull requests up-to-date. As you do not want to trigger your CI too often by always re-running it on every pull request — especially when there is still work in progress — you can limit this action to labeled pull requests.

pull_request_rules:
  - name: automatic update for PR marked as “Ready-to-Go“
    conditions:
      - -conflict # skip PRs with conflicts
      - -draft # filter-out GH draft PRs
      - label="Ready-to-Go"
    actions:
      update:

When a pull request is not in conflict nor draft, and has the label Ready-to-Go, it will be automatically updated with its base branch.