View as Markdown

Mergify Dequeue Command

Remove a pull request from a merge queue.


The dequeue command removes a pull request from the merge queue. This command is ideal for situations where you realize a pull request either shouldn’t be merged or needs further revision before merging.

@Mergifyio dequeue

A queue command leaves a pull request in one of two states, and dequeue covers both:

  • In the queue. Mergify takes the pull request out and reports that it has been removed from the queue.

  • Waiting to enter it. A queue command stays pending until the pull request matches a queue’s queue_conditions. dequeue cancels that pending command, so the pull request is not queued later when the conditions eventually match.

When neither applies, Mergify answers that the pull request is not queued and does nothing else.

A dequeued pull request never rejoins the queue on its own. Run @mergifyio queue again once it’s ready, as described in Requeuing a Pull Request in the Merge Queue.

Dequeuing a pull request that others are stacked on top of also removes the ones above it that are still in the queue. See cascade dequeue.

Was this page helpful?