Mergify Queue Command

The queue command in Mergify offers users a direct way to interact with the Mergify merge queue, right from their pull request comments. By utilizing this command, users can add a pull request to a merge queue or re-add it after it has been dequeued.

To enter a queue, a pull request must match the queue_conditions of the targeted queue. See Adding a Pull Request to the Merge Queue for more details.

@mergifyio queue [queue-name]

• [queue-name] is an optional queue name. If no queue name is specified, the pull request will be queued in the first queue that matches the queue_conditions.

To add a pull request to a queue, simply use:

@mergifyio queue

This command will place the pull request in the first queue that matches queue_conditions.

To add a pull request to a specific queue, simply use:

@mergifyio queue production

This command will place the pull request in the production queue as soon as it passes its queue_conditions.

If a pull request was removed from the merge queue — whether due to a failed check, a flaky test, or a manual dequeue — you can re-add it using the same queue command:

@mergifyio queue

The command resets the pull request status and places it back in the merge queue, allowing Mergify to retry validation.

If you’d rather not type a command, Mergify can post a merge queue status comment with a checkbox you can tick to queue your pull request:

• Queue this pull request appears when the pull request is ready to be queued. Tick it to add the pull request to the merge queue.

• Requeue this pull request appears after a pull request leaves the queue following a failed attempt. Tick it to put the pull request back in the queue.

Ticking a checkbox does exactly what the @mergifyio queue command does. The action is attributed to the person who ticked it, and the same command restrictions and write-permission checks apply, so a checkbox can’t queue a pull request that the person couldn’t queue manually.

This is enabled by default. To turn it off, set queue_controls_comment to false in your merge_queue configuration:

merge_queue:
  queue_controls_comment: false