Why Don't My Pipeline Stages Show on New Jobs

This article explains why pipeline stages created in Settings don't automatically appear on new jobs. You need to add them to a workflow for them to show up.

Why this happens

Adding stages at Settings / Pipeline Stages creates the stages, but doesn't automatically add them to any workflow.

Jobs use workflows, and workflows contain specific sets of stages. A stage must be added to a workflow before it appears on jobs using that workflow.

How to fix

Option 1: Add stages to default workflow

1. Open any job
2. Go to the Workflow tab
3. Find the dropdown at the bottom
4. Search for your stage and add it
5. Save
6. This updates the default workflow for all jobs using it

Option 2: Create a custom workflow

1. Open a job's Workflow tab
2. Enable "Use different workflows for different jobs"
3. Create a new workflow
4. Add your custom stages to this workflow
5. Assign this workflow to relevant jobs

Understanding the relationship

Settings / Pipeline Stages = Available stages (the library)
Workflows = Sets of stages used by jobs
Jobs = Use a specific workflow

Creating a stage in settings is like adding a book to a library. You still need to put the book on a shelf (workflow) for it to be used.

Quick reference

Updated on: 28/12/2025