close
The Wayback Machine - https://web.archive.org/web/20220408105022/https://docs.github.com/en/actions/managing-workflow-runs/removing-workflow-artifacts
Skip to main content
Free, Pro, & Team
English
Sign up
 
GitHub Actions
Free, Pro, & Team
English
Sign up

 

Removing workflow artifacts

In this article

You can reclaim used GitHub Actions storage by deleting artifacts before they expire on GitHub.

Deleting an artifact

Warning: Once you delete an artifact, it can not be restored.

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

By default, GitHub stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "Usage limits, billing, and administration."

  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. Under Artifacts, click next to the artifact you want to remove.

    Delete artifact drop-down menu

Setting the retention period for an artifact

Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "Usage limits, billing, and administration."

You can also define a custom retention period for individual artifacts using the actions/upload-artifact action in a workflow. For more information, see "Storing workflow data as artifacts."

Finding the expiration date of an artifact

You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the expires_at value returned by "List artifacts for a repository."