GitHub Actions environment protection rules blocked the job

By Kaveh Alemi·Latchkey

A job targeting a protected environment is held or rejected by its protection rules. This is policy, not a failure to retry; the job waits for approval or a passing condition.

What this error means

The job sits as "Waiting" for a reviewer, or is rejected because the branch is not allowed to deploy to the environment.

Deployment to environment 'production' is waiting for approval from required reviewers
# or: Branch "feature/x" is not allowed to deploy to production due to environment protection rules

Common causes

Required reviewers

The environment requires a manual approval before the job proceeds.

Deployment branch policy

Only specified branches may deploy; other branches are blocked.

How to fix it

Satisfy or adjust the protection rules

1. Have a required reviewer approve the pending deployment.
2. Deploy from an allowed branch, or update the environment branch policy.

environment:
  name: production

How to prevent it

• Document which branches may deploy to each environment.
• Make sure required reviewers are available for time-sensitive deploys.

Frequently asked questions

Related guides

References

• GitHub Actions documentation
• Workflow syntax for GitHub Actions