Changelog

Automatic migration from autoqueue to auto_merge_conditions

Mergify now opens a migration PR that converts the deprecated `queue_rules[].autoqueue` setting to the new `merge_protection_settings.auto_merge_conditions`.

conditions in queue rules is deprecated

The `conditions` attribute in queue rules is deprecated and will be removed on 2026-07-31 — use `merge_conditions` instead.

Declarative commit_message_format for merge commits

Configure merge commit titles, bodies, and trailers declaratively without writing Jinja2 templates.

Delegate Mergify admin powers to non-GitHub Owners

GitHub Owners can now delegate specific Mergify admin powers to individual users without granting them GitHub Owner rights.

Restrict auto-merge to specific pull requests with auto_merge_conditions

Configure which pull requests are eligible for auto-merge using a list of conditions instead of a global on/off toggle.

routing_conditions in queue rules is deprecated

The `routing_conditions` attribute in queue rules is deprecated and will be removed on 2026-07-31 — use `queue_conditions` instead.

Mergify Terraform provider

Manage Mergify product enablement declaratively with Terraform

unqueue command alias removed

The deprecated `unqueue` command alias has been removed; use `dequeue` instead.

Buildkite support for CI Insights

Connect your Buildkite pipelines to Mergify CI Insights to track build and job performance alongside your GitHub Actions and Jenkins data.

Auto-merge setting in Merge Protections

New auto_merge setting that automatically merges or queues PRs when all merge protection conditions pass, replacing the deprecated autoqueue in queue rules.

Automated migration for check interruption default change

An automated configuration migration adds explicit `allow_checks_interruption: true` to priority rules with priority higher than medium, preparing for the upcoming default change.

Check interruption disabled by default for priority rules

The default for `allow_checks_interruption` in priority rules changes from true to false, so higher-priority pull requests no longer interrupt running checks unless explicitly configured.

Extended statistics date range to 3 months

You can now view merge queue statistics for up to 3 months instead of the previous 1-month limit.

Merge queue rebase with update_bot_account on fork pull requests

Using the merge queue with `update_method=rebase` and `update_bot_account` on fork pull requests is deprecated and will be removed on July 1, 2026.

Pull request scopes API is now public

The endpoint to set scopes on pull requests is now available in the public API.

Unified "Mergify Merge Queue" check run

A single "Mergify Merge Queue" check run on pull requests, providing a unified view of merge queue status.

Regex tester for auto-retry log patterns

Test your regex patterns against sample log lines directly in the auto-retry rule builder.

Parallel scopes

Merge unrelated pull requests in parallel by grouping them into scopes based on the files they touch.

New scope attribute available for conditions

A new `scope` field is now exposed through pull requests attributes and can be used in conditions

Native RSpec Integration for Test Insights

RSpec projects can now use the rspec-mergify gem for automatic test result upload, flaky test detection, and flaky test prevention

New merge-batch merge method for merge queue

A new merge-batch merge method merges the draft pull request prepared by the merge queue directly into the base branch

rebase action with bot_account on fork pull requests

The `rebase` action with `bot_account` impersonation on fork pull requests is deprecated and will be removed on July 1, 2026.

Deprecation of queue_branch_merge_method

queue_branch_merge_method is deprecated in favor of merge_method: fast-forward, which now works in both inplace and draft-PR modes.

Deprecation of action delete_head_branch

The `delete_head_branch` action is deprecated.

Match CI log patterns against check run annotations

Auto-retry log patterns now also match against GitHub check run annotations, not just log output.

Log pattern matching for auto-retry rules

Auto-Retry rules can now match against job log content to decide whether a failed job should be retried

Merge Queue: PR exit reasons and idle time breakdown in stats

New stats endpoints for the merge queue dashboard: PR exit reasons count (unique PRs by final exit reason) and idle time breakdown (capacity, schedule, freeze). Powers the new Sankey flow diagram and stacked time chart.

Automatic CI retries in merge queue

You can now configure Mergify to automatically retry failed CI checks before removing a pull request from the queue.

Deprecation of post_check action

Automatic migration of post_check actions to merge_protections entries

Time-binned merge queue checks outcome endpoint

New API endpoint to track dequeue reasons over time as a time-series graph

Merge queue intake statistics endpoint

New API endpoint to track pull requests entering the merge queue over time

Batch bisection statistics API

New API endpoint to track merge queue bisection events, helping users optimize their batch size configuration.

Test Insights: mitigation

View quarantined tests on the default branch and turn auto-quarantine on so flaky tests don’t block merges.

Merge Queue failure rate statistics

A new failure_rate endpoint is available in the merge queue statistics API, returning the ratio of failed to total PRs leaving the queue, broken down by time intervals.

Test Insights: prevention and detection

Stop flaky tests from slowing you down. Prevention shows what gets caught before merge; Detection helps you find and fix the worst offenders.

API support for GitHub PAT

It’s possible for users to use the API

The requeue command is deprecated

The queue command can now requeue pull requests

New retry mode for failed jobs

CI Insights Auto Retry gets a new retry mode

autosquash has been deprecated

`autosquash` option will be removed soon

Add ability for retry rules to retry entire pipelines

Allow users to retry rules by choosing the retry mode

Allow to configure schedule freeze exclusion conditions

Schedule Freeze exclusion conditions can now be configured

New Merge Queue status dashboard

The redesigned merge queue interface is now available to everyone

Add none option to status_comments for merge queue

A new `none` value is now available for the `status_comments` configuration option to completely disable merge queue status comments on pull requests.

Allow to configure merge queue comment reporting

The status reported by the merge queue as comments can now be configured

Improved Merge Queue status reporting

Release of the Merge Queue status updates

Improved Merge Queue status reporting (beta)

Improved Merge Queue status updates now give clearer, real-time insights into PR progress.

Bypass the injection of rulesets conditions in the Merge Queue

Use the `exempt` bypass-actor mode for Mergify in your ruleset to skip injecting ruleset conditions into the Merge Queue.

Adding merge queue commands to event log

Commands for the merge queue are now recorded as part of the event log

Skip intermediate results

Allows merging a PR early if a later batch including it passes all checks and conditions.

New changelog

New unified changelog experience 🚀

New statistics page visuals

We upgraded the looks of the statistics page, including better charts and tooltips visuals.

New glob operator for conditions in the configuration

Adds the `*=` operator for glob-style pattern matching in conditions

Unsuccessful checks are displayed on checks event

Better way to find unsuccessful checks

New Queue Resets & Batch Interruptions chart

New dedicated chart to track errors and problems in the merge queue, including failed checks, timeouts, queue resets, and batch failures.

Dequeued label on PR

New label for identifying dequeued pull requests

allow_inplace_checks has been deprecated

`allow_inplace_checks` is deprecated — checks are now placed automatically based on `batch_size`, `merge_conditions`, and `max_parallel_checks`.

Add/remove queued label automatically on PRs

New `queued_label` option on `merge_queue` automatically tags pull requests as they enter and leave the queue.

Custom column display in CI Insights

Toggle column visibility in CI Insights tables — preferences persist locally and travel with the URL when shared.

Test failure details in PR comments

CI Insights PR comments now include test-level details: failed tests, flaky test history, and links to investigate further.

Validate your configuration locally with a pre-commit hook

Mergify's official pre-commit hook validates your configuration locally before you push.

Autoqueue option for queue rules

New `autoqueue` field on `queue_rules` automatically queues matching pull requests, removing the need for explicit `queue` actions.

CI Insights PR report

CI Insights now posts a summary comment on every pull request — failed jobs, flaky tests, execution time, and CI health at a glance.

Partition rules are now deprecated

`partition_rules` is deprecated — use `queue_rules` instead. Existing configurations are being upgraded.

Allow to disable comment posting

New configuration option enables or disables the comment posted by Merge Protections.

Remove deprecated implicit priority between queue rules

Implicit ordering by queue-rule definition is gone — use `priority_rules` to control merge order.

Remove deprecated options of queue action

The deprecated options of the `queue` action have been removed.

max_parallel_checks is now 5 by default

`max_parallel_checks` now defaults to 5, reducing merge latency without overusing CI resources.

GET /products/{owner} endpoint has been removed

The `GET /products/{owner}` endpoint is replaced by `GET /repos/{owner}`, which returns more data.

Add deployment success/failure to conditions

New `deployment-success` and `deployment-failure` conditions list a pull request's deployments and their outcome.

Autosquash disabled by default for the queue action

`autosquash` is now off by default for the `queue` action, so Mergify can rebase without impersonating the author.

Statistics by priority

Merge Queue statistics are now broken down by pull request priority.

Datadog scheduled freeze metrics

The Datadog integration now sends a metric for the number of ongoing scheduled freezes.

disallow_checks_interruption_from_queues has been deprecated

The `disallow_checks_interruption_from_queues` option has been removed — use `priority_rules` instead.

Removal of queue freeze attributes

The `queue-freeze` and `queue-freeze-reason` pull request attributes have been removed.

Average batch size stats

New API endpoint and dashboard chart expose average batch size statistics for your merge queue.

priority_rules from queue_rules removal

The deprecated `priority_rules` section under `queue_rules` has been removed — it's now top-level.

Deprecated autoquash option removal

The deprecated `autosquash` option has been removed from the `queue` action — set it under `queue_rules` instead.

Remove deprecated allow_checks_interruption

The deprecated `allow_checks_interruption` option has been removed.

Remove deprecated allow_merging_configuration_change option

The deprecated `allow_merging_configuration_change` option has been removed — it had been a no-op for the past year.

Scheduled freezes support in Slack

Send scheduled freeze creation, update, and deletion events from Merge Protections directly to a Slack channel.

Merge Queue Freeze API is deprecated

The Freeze API is replaced by the Pause API, which adds `allow_checks_to_run` to mimic the previous behavior.

New updates attribute available for conditions

New `updates` attribute exposes the list of updates pushed to a pull request's branch, usable in conditions.

Slack integration

Mergify integrates natively with Slack — send your merge queue activity to any channel.

Merge Protections reports pending events

Merge protections with pending conditions (running CI, schedules) now report as pending instead of failing.

Datadog integration

New agent-less Datadog integration sends merge queue metrics straight from Mergify — enable it from your dashboard.

Add max_parallel_checks

New `max_parallel_checks` option for `merge_queue` controls parallel checks and replaces the deprecated `speculative_checks`.

Add allow_checks_interruption option in priority_rules section

Priority rules now support `allow_checks_interruption`, letting higher-priority PRs interrupt running checks.

Allow to have queue_rule in defaults section

Set defaults for queue rules — including `bot_account` and `batch_size` — via the `defaults` section, including across extended configurations.

Priority_rules is now at the top level of the Mergify config

`priority_rules` is now a top-level option, with priorities applied globally across the merge queue.

Queue action options deprecation

All `queue` action options are deprecated — configure them under `queue_rules` instead.

Allow to specify merge_conflict_style for copy and backport actions

Set `merge_conflict_style: diff3` on `copy` and `backport` to use the diff3 style for conflict markers.

Add merge-commit-sha attribute

New `merge-commit-sha` attribute exposes a pull request's merge commit SHA1 in rules and templates.

Expose the number of added/deleted/modified lines

New `#added-lines`, `#deleted-lines`, and `#modified-lines` attributes expose line-change counts in conditions and templates.

Add merge queue total queue time

New API endpoint exposes the total queue time for pull requests, also surfaced in the dashboard statistics.

Add support for description key in pull_request_rules

New `description` key documents what each pull request rule does.

Add copy/backport action "report_mode" option

New `report_mode` parameter lets you report `copy` and `backport` results as a GitHub check or as a comment.

Copy/backport actions post comment with cherry-pick error

When `copy` or `backport` fails to cherry-pick, Mergify now posts the error as a comment on the target pull request.

allow_merging_configuration_change option is deprecated

Use `-mergify-configuration-changed` in your conditions instead — `allow_merging_configuration_change` is deprecated.

Add new endpoint for queue checks outcome

New API endpoint exposes statistics on queue checks outcome, replacing the previous endpoint.

Stats endpoints for the number of running checks

New statistics endpoint exposes the number of concurrent running checks.

Add mergify-configuration-changed condition

New boolean condition `mergify-configuration-changed` is true when a pull request modifies the Mergify configuration.

API endpoint for average/min/max queue size

New API endpoint exposes the average, minimum, and maximum size of your merge queues over recent weeks.

New API stats endpoint for average idle queue time

Add an endpoint with stats average runtime

Expose queue-frozen and queue-freeze-reason attribute

New endpoint queues merged count by time intervals

Drop require_branch_protection option

Add queue-name attribute

Rename "unqueue" command to "dequeue"

Add neutral_conditions to post check action

/events API deprecation

Add attribute head-repo-full-name

Autodetect best merge method

New unqueue reason for branch update failure

Add unqueue reasons for conflicts

Add branch_protection_injection_mode to bypass branch protections

Add condition queue-dequeue-reason

New action: github_actions

Automatically reembark pull request with requeue command

Add added/modified/removed-files attributes

Support unspecified digits for current-datetime attribute

Move require_branch_protection config option to queue_rules

Support timestamp intervals

Add current-datetime condition

Rename queue action method option in merge_method

Add co-authors attribute

Merge Queue Pause

New Actions read permission

Remove queue action 'priority' attribute

Add new queue_checks_outcome endpoint that includes all partitions and queues

Add time_to_merge endpoint that has data of all partitions and queues

Support Merge-After condition in PR body

Allow to use autosquash with rebase update method

Star attribute in commits list

Add partition_rules

Drop rebase_fallback option

Open draft PR if no bot account is set and rebase is used

Add routing_conditions attribute to queue_rules

Allow to merge Mergify configuration automatically

Priority option for queue is deprecated

Rebasing pull requests with a random user is deprecated

Add a merge_conditions to queue_rules to replace conditions

Allow labels value to have template variables

Add batch_max_failure_resolution_attempts

Add priority rules

Conditions can access commit details

Option priority of merge action is deprecated

Default value for rebase_fallback

rebase_fallback is deprecated

Add freeze cascading effect disabling

New statistics API

Rebase action autosquash when PR is up-to-date

New toggle option for the label action

Deprecation of current-* conditions

Improve branch protection compatibility

Queue statistics dashboard

Allow templating in conditions

branch-protection-review-decision boolean conditions

Allow to extend configuration

Queue branch merge method

Event logs availability

Allow queue branch edition

Commands restrictions

New dependabot attributes

New queue command

New shared configuration support

Queue branch prefix is now configurable

allow_inplace_checks changes

commits-behind change

commit_message removed

API configuration validation endpoint

fast-forward merge method

requeue and unqueue commands

Queue freeze feature

New option disallow_checks_interruption_from_queue

repository-name and repository-full-name

Add draft_bot_account

strict mode removed

batch_max_wait_time defaults to 30s

New option batch_max_wait_time