Skip to main content

Re-running workflows and jobs

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

Who can use this feature

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

About re-running workflows and jobs

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.

Re-running all the jobs in a workflow

  1. On your enterprise, 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 to see the workflow run summary.

    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.

    If no jobs failed, you will not see the Re-run jobs drop-down menu. Instead, click Re-run all jobs.

    Rerun checks drop-down menu

  6. 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 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 your enterprise, 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 to see the workflow run summary.

    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.