English

Explore by product

GitHub Actions
English
Article version: GitHub.com
Article version: GitHub.com

Re-running a workflow

You can re-run an instance of a workflow. Re-running a workflow uses the same GITHUB_SHA (commit SHA) and GITHUB_REF (Git ref) of the original event that triggered the workflow run.

GitHub Actions is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server, and GitHub AE. GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans. For more information, see "GitHub's products."

Write access to the repository is required to perform these steps.

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Actions. Actions tab in the main repository navigation
  3. In the left sidebar, click the workflow you want to see. Workflow list in left sidebar
  4. From the list of workflow runs, click the name of the run you want to see. Name of workflow run
  5. In the upper-right corner of the workflow, use the Re-run jobs drop-down menu, and select Re-run all jobs.Re-run checks drop-down menu

To download or find more information about GitHub CLI, see the GitHub CLI feature page.

For information on setting up GitHub CLI, see "Managing GitHub Actions with GitHub CLI."

To re-run a failed workflow run, use the run rerun subcommand. Replace run-id with the ID of the failed run that you want to re-run. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent failed run.

gh run rerun run-id

To view the progress of the workflow run, use the run watch subcommand and select the run from the interactive list.

gh run watch

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.