--- title: Mergify Documentation description: Explore & learn Mergify suppressTitle: true --- import Docset from '../../components/DocsetGrid/Docset.astro'; import DocsetGrid from '../../components/DocsetGrid/DocsetGrid.astro'; import CommunityButton from '../../components/CommunityButton.astro'; import MergeQueueIcon from '../../components/MergeQueueIcon.astro';
{/* ---------------- HERO ---------------- */}

Mergify Documentation

Ship faster with healthier CI, safer merges, and powerful workflow automation.

CI Insights Merge Queue Monorepo CI Merge Protections Workflow Automation
{/* -------------- PRODUCT SECTIONS -------------- */}

CI Insights

Insights & automation to make your test suite lean and reliable. What CI Insights gives you. Surface inconsistent tests & jobs. Automatic transient failure retries. Isolate noisy tests to unblock merges. Configure report upload.

Monorepo CI

Scope-aware CI workflows that only run the jobs that matter. Define scopes once and reuse them across CI. Wire scopes into gha-mergify-ci workflows. Share scopes with batching strategies.

Merge Queue

Deterministic, parallel, and resource‑aware merging. 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.

Merge Protections

Advanced guardrails before code lands. 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.

Workflow Automation

Expressive rule engine & rich actions to eliminate manual toil. 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.

Reference & Platform

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. {/* -------------- COMMUNITY -------------- */}

Join our Community 💬

Share feedback, ask questions, and see what other teams build with Mergify.