English
No results found.

Explore by product

GitHub Actions
  • Get started
  • Account and profile
  • Authentication
  • Repositories
  • GitHub
  • Enterprise administrators
  • Billing and payments
  • Organizations
  • Code security
  • GitHub Issues
  • GitHub Actions
  • GitHub Codespaces
  • GitHub Packages
  • Search on GitHub
  • Developers
  • REST API
  • GraphQL API
  • GitHub CLI
  • GitHub Discussions
  • GitHub Sponsors
  • Building communities
  • GitHub Pages
  • Education
  • GitHub Desktop
  • Atom
  • Electron
  • CodeQL
    • English
  • English
  • 简体中文 (Simplified Chinese)
  • 日本語 (Japanese)
  • Español (Spanish)
  • Português do Brasil (Portuguese)
    • Article version

    Viewing workflow run history

    You can view logs for each run of a workflow. Logs include the status for each job and step in a workflow.

    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."

    Read 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

    To learn more about GitHub CLI, see "About GitHub CLI."

    Viewing recent workflow runs

    To list the recent workflow runs, use the run list subcommand.

    gh run list

    To specify the maximum number of runs to return, you can use the -L or --limit flag . The default is 10.

    gh run list --limit 5

    To only return runs for the specified workflow, you can use the -w or --workflow flag. Replace workflow with either the workflow name, workflow ID, or workflow file name. For example, "Link Checker", 1234567, or "link-check-test.yml".

    gh run list --workflow workflow

    Viewing details for a specific workflow run

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

    gh run view run-id

    To include job steps in the output, use the -v or --verbose flag.

    gh run view run-id --verbose

    To view details for a specific job in the run, use the -j or --job flag. Replace job-id with the ID of the job that you want to view.

    gh run view --job job-id

    To view the full log for a job, use the --log flag.

    gh run view --job job-id --log

    Use the --exit-status flag to exit with a non-zero status if the run failed. For example:

    gh run view 0451 --exit-status && echo "run pending or passed"

    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.