Reviewing deployments

You can approve or reject jobs awaiting review.

GitHub Actions is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server, GitHub One, and GitHub AE. GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans. Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for GitHub Enterprise. For more information, see "GitHub's products."

In this article

Note: Environments, environment protection rules, and environment secrets are currently in beta and subject to change.

About required reviews in workflows

Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled.

For more information about environments and required approvals, see "Environments." For information about how to review deployments with the REST API, see "Workflow Runs."

Approving or rejecting a job

  1. Navigate to the workflow run that requires review. For more information about navigating to a workflow run, see "Viewing workflow run history."
  2. Click Review deployments.
    Review deployments
  3. Select the job environment(s) to approve or reject. Optionally, leave a comment.
    Approve deployments
  4. Approve or reject:
    • To approve the job, click Approve and deploy. Once a job is approved (and any other environment protection rules have passed), the job will proceed. At this point, the job can access any secrets stored in the environment.
    • To reject the job, click Reject. If a job is rejected, the workflow will fail.

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.