Assign

The assign action allows you to assign one or more users to a pull request when the conditions you specify are met. This can help automate the process of designating the right people to handle specific pull requests, based on your conditions.

Each entry in users, add_users or remove_users is a User: a GitHub login, or the {{ author }} variable to assign the pull request to its author. users is the older form of add_users and behaves the same way; prefer add_users in new rules.

Mergify skips any login ending in [bot] when adding assignees, so a rule that assigns {{ author }} does nothing on a pull request opened by a bot.

Below is an example of how to use the assign action:

pull_request_rules:
  - name: assign PR to a user
    conditions:
      - "#files = 1"
    actions:
      assign:
        add_users:
          - "username1"
          - "username2"

Below is an example of how to use the assign action to assign a pull request to its author:

pull_request_rules:
  - name: assign PR to its author
    conditions:
      - "#files = 1"
    actions:
      assign:
        add_users:
          - "{{ author }}"