CircleCI "config has no workflows" / no jobs run

By Kaveh Alemi·Latchkey

A pipeline triggered but no job ran. In config 2.1 a job only runs when a workflow references it; without a workflows block (or with an empty one), there is nothing to schedule.

What this error means

The pipeline shows no jobs, or validation warns that the config has jobs but no workflow references them.

* Config does not conform to schema:
  - At least one workflow must be defined, or jobs must be referenced from a workflow.

Common causes

No workflows block

The config defines jobs but omits the workflows key, so CircleCI has no entry point to run anything.

A workflow that references no jobs

The workflows block exists but its job list is empty or commented out, so nothing executes.

How to fix it

Reference jobs from a workflow

1. Add a top-level workflows key.
2. List each job that should run under a named workflow.
3. Add requires: to order dependent jobs.

workflows:
  ci:
    jobs:
      - build
      - test:
          requires: [build]

Validate the config

Validation confirms at least one workflow references your jobs.

circleci config validate

How to prevent it

• Add every job to a workflow so it actually runs.
• Keep requires: graphs acyclic and complete.
• Validate config so an empty workflow is caught early.

Frequently asked questions

Related guides

References

• GitHub Actions documentation