Re-running workflows and jobs

You can re-run a workflow run up to 30 days after its initial run.

People with write permissions to a repository can re-run workflows in the repository.

Re-running all the jobs in 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. You can re-run a workflow for up to 30 days after the initial run.

  1. On GitHub.com, 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 Rerun checks drop-down menu

To learn more about GitHub CLI, see "About 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

Reviewing previous workflow runs

You can view the results from your previous attempts at running a workflow. You can also view previous workflow runs using the API. For more information, see "Get a workflow run".

  1. On GitHub.com, 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. Any previous run attempts are shown in the left pane. Rerun workflow
  6. Click an entry to view its results.

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.