Mergify Documentation

What CI Insights gives you.

Surface inconsistent tests & jobs.

Automatic transient failure retries.

Isolate noisy tests to unblock merges.

Configure report upload.

Define scopes once and reuse them across CI.

Wire scopes into gha-mergify-ci workflows.

Share scopes with batching strategies.

Core concepts & guarantees.

Enable & configure your first queue.

Route PRs & define policies.

From enqueue to merge.

Order critical work first.

Batch compatible PR tests.

Throughput & optimization tips.

Increase velocity with batches.

Group pull requests by impacted services.

Optimization for large repositories.

Fast + full validation strategy.

Adopt safely in production.

Key metrics & dashboards.

Protection capabilities.

Enable and mark check required.

Depends-On, Merge-After, config safety.

Define granular success logic.

Schedule or trigger merge freezes.

Common rule recipes.

What you can automate.

Create your first automation.

Full action catalog.

Merge when policy satisfied.

Smart reviewer assignment.

Invalidate outdated approvals.

Keep repo tidy automatically.

Keep branches current.

YAML structure & semantics.

Filter syntax details.

All supported value kinds.

Reuse config across repos.

ChatOps style commands.

Authenticate & call the API.

Endpoint reference.

CI & ecosystem hooks.

Move from other tools with step‑by‑step guides.

Stacked PR workflow.

Public project badge.

Security & permissions.

Contact channels & response goals.

Plans & billing model.