Quality Gate

You might say

Why is my Pull Request blocked with an error saying 'Quality gate failed'?

A set of conditions that decide whether code may be merged or a release may proceedAll tests may pass while coverage remains below the agreed 80%, keeping a pull request blocked. Checks produce results and the gate evaluates them; branch protection must require that result to enforce the merge restriction.

Know first

Unit Test CI

Quality Gates

Why passing tests can still leave a PR blocked

PR #42 · Order exportMerge blocked

Required checkQuality gate

Unit tests✓ 45 / 45

Lint✓ 0 errors

Coverage · required ≥ 80%× 68%

Merge actionWaiting for coverage to pass

All 45 tests pass, but 68% coverage is below the agreed 80%, so the required check still fails.

How results become merge requirements

Agree on criteria, then enforce them: Set criteria according to project risk, such as passing critical tests and no severe security findings. CI runs checks; require the gate result in branch protection to block changes that fail.

Use the failure report to choose a fix: For low coverage, inspect untested paths; for failing tests, compare actual and expected results. Rerunning unchanged code or lowering the threshold does not prove that the original problem was fixed.

Quick checkChoose the best answer

All 45 PR tests pass, but coverage is 68% against a required 80%. What should happen next?

Add tests for the uncovered paths, then check the new resultRerun the same checks without changing the code or testsLower the threshold to 60%, then check whether it passes

You can say this to an AI Agent

This PR failed its quality gate. Inspect the report, fix the missing tests or code issue, rerun the checks, and verify that the original gate criteria are satisfied.

Continue learning

1CI→2Test Coverage→3Feature Flag→

Recommended tool

Web fine-tuning tool · Selector Pro

Select page elements for precise AI edits

Click a button, text, or card, note the change, then copy its exact location to AI.

Open Selector Pro website