Promotion gates

7 min readLast updated 2026-04-26New

Define the criteria that must pass before code can merge, deploy, or release.

Promotion gates are configurable checkpoints in your delivery pipeline. They combine test results, coverage, security scans, and manual approvals.

Gate stages

Merge gateRequired before PR merge: tests pass, coverage met, no critical bugs
Deploy gateRequired before staging deploy: merge gate passed, security scan clean
Release gateRequired before production: deploy gate passed, release readiness score >= 80

Custom criteria

Add custom checks via webhooks. When a gate evaluates, Check Studio POSTs to your endpoint and expects a 200 for pass.

{
  gates: [{
    name: 'security-scan',
    type: 'webhook',
    url: 'https://security.internal/api/gate',
    timeout: 30000,
  }]
}
javascript

Was this article helpful?

Still have questions?

Our support team is here to help. Reach out directly or search the docs.