# Pipeline Stage

> One step of a pipeline, like build, test or deploy. It holds jobs.

**Field:** Software Development  
**Category:** DevOps & Cloud  
**Also known as:** CI Stage, Pipeline Job, CI Job, Build Job

## Think of it like

Think of it like rooms in a car wash. The car goes through soap, then rinse, then dry, in that order.

## Definition

A pipeline stage is one step of a CI/CD pipeline, like build, test or deploy. Each stage holds one or more jobs, and a job is one task, like running the unit tests. Jobs in the same stage can run side by side. Stages run in order. If a job fails, the stages after it usually do not run.

## Example

Jack's pipeline has three stages. The test stage runs unit tests and a linter side by side, then deploy waits for both.

## Example code

```yaml
stages:
  - build
  - test

unit-tests:
  stage: test
  script:
    - npm test
```

A GitLab file with two stages and one job in the test stage.

## Why it matters

Stages show where a change failed. They also stop a bad build from going live.

## Common mistake

Putting every check in one long job. Split them, so they run side by side and fail clearly.

## Three principles

- **In order.** Build, then test, then deploy.
- **Jobs inside.** Each job is one task.
- **Stop on failure.** Later stages wait for success.

## Related terms

- [CI/CD Pipeline](https://learn.benibix.com/term/development/ci-cd-pipeline)
- [CI Runner](https://learn.benibix.com/term/development/ci-runner)
- [Continuous Integration (CI)](https://learn.benibix.com/term/development/continuous-integration)
- [GitLab CI/CD](https://learn.benibix.com/term/development/gitlab-ci-cd)

![A pipeline drawn as three stages in a row: build, test and deploy. Each stage holds jobs, like compile, unit tests and lint, and the jobs in one stage run side by side. A runner, lit up, is the machine that picks up each job and runs it. Below, the same pipeline is shown as three config files: .github/workflows for GitHub Actions, .gitlab-ci.yml for GitLab CI/CD and a Jenkinsfile for Jenkins.](https://learn.benibix.com/diagrams/dev3-pipeline-stages.svg)

---

Source: https://learn.benibix.com/term/development/pipeline-stage
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
