What Is a Commit Status?
A commit status is a lightweight marker that an external service posts against a specific commit, reporting one of success, failure, pending, or error along with a context label and target URL. It predates the richer Checks API and remains widely used by CI and integrations. Branch protection can require specific status contexts to pass before merge.
Why it matters
Commit statuses are the simplest cross-system signal that a commit is good or bad, which is why so many tools still emit them. They lack the annotations and structured detail of check runs, but their simplicity makes them universal for gating merges.
Related concepts
- Simpler than the Checks API check run
- Each status carries a context label and target URL
- Required statuses gate merges in branch protection
Related guides
What Is a Check Run?A check run is a single test or validation reported against a commit, with a status, conclusion, and optional…
What Is a Status Check?A status check is a pass/fail signal a pipeline reports back to a commit or pull request, often required befo…
What Is Branch Protection?Branch protection enforces rules on important branches, like required reviews and status checks, before chang…