Skip to content
Latchkey

GitHub Actions "Waiting for approval to run workflows for this PR"

A PR can sit indefinitely with no checks running while it waits for a maintainer to approve the workflow run. Until approved, no jobs are dispatched, so required checks never report.

What this error means

PR checks show no progress and the run is in a "waiting for approval" state.

github-actions
Waiting for approval to run workflows for this pull request.
A repository maintainer must approve before these workflows will run.

Common causes

Pending maintainer approval

The repo requires approval before workflows run on this PR and no one has approved yet.

How to fix it

Approve the queued run

  1. A user with write access opens the PR and clicks Approve and run.
  2. If required status checks are blocking merge, they will only appear after approval.

How to prevent it

  • Notify maintainers when external PRs are awaiting approval.
  • Set the approval policy to match your contributor trust level.

Frequently asked questions

What causes ""Waiting for approval to run workflows""?
The repo requires approval before workflows run on this PR and no one has approved yet.
How do I fix "Waiting for approval to run workflows"?
Approve the queued run

Related guides

References

Latchkey auto-heals failures like this one - detected, fixed, and retried without you. Start free → 30-day trial · No credit card