Deleting a container image

You can delete a specific version or all versions of a private or public container image on GitHub.

GitHub Packages is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 2.22, and GitHub One.


GitHub Packages is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access GitHub Container Registry since these accounts are billed by repository. For more information, see "GitHub's products."

In this article

Note: GitHub Container Registry is currently in public beta and subject to change. During the beta, storage and bandwidth are free. To use GitHub Container Registry, you must enable the feature preview. For more information, see "About GitHub Container Registry" and "Enabling improved container support."

About package deletion

You can remove an entire container image or a specific version on GitHub. To delete a container image, you must use the UI. Using GraphQL to delete a container image is not supported at this time.

To delete a container image, you must have admin permissions to the container image.

When deleting public packages, be aware that you may break projects that depend on your package.

Deleting a version of a user-owned container image on GitHub

To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "Deleting all versions of a user-owned container image on GitHub."

  1. On GitHub, navigate to the main page of your user account.
  2. In the top right corner of GitHub, click your profile photo, then click Your profile.
    Profile photo
  3. On your profile page, in the top right, click Packages.
    Packages option on profile page
  4. Search for and select your package.
  5. In the top right of your container image's landing page, click Package settings.
    Package settings button
  6. On the left, click Manage versions.
  7. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select All.
    Package version type drop down menu showing option to list all versions
  8. To the right of the version you want to delete, click and select Delete version.
    Delete package version button
  9. To confirm deletion, type the package name and click I understand the consequences, delete this version.
    Confirm package deletion button

Deleting a version of an organization-owned container image on GitHub

To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "Deleting all versions of an organization-owned container image on GitHub."

  1. On GitHub, navigate to the main page of your organization.
  2. Under your organization name, click Packages.
    Container access invite button
  3. Search for and select your package.
  4. In the top right of your container image's landing page, click Package settings.
    Package settings button
  5. On the left, click Manage versions.
  6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select All.
    Package version type drop down menu showing option to list all versions
  7. To the right of the version you want to delete, click and select Delete version.
    Delete package version button
  8. To confirm deletion, type the package name and click I understand the consequences, delete this version.
    Confirm package version deletion button

Deleting all versions of a user-owned container image on GitHub

  1. On GitHub, navigate to the main page of your user account.
  2. In the top right corner of GitHub, click your profile photo, then click Your profile.
    Profile photo
  3. On your profile page, in the top right, click Packages.
    Packages option on profile page
  4. Search for and select your package.
  5. In the top right of your container image's landing page, click Package settings.
    Package settings button
  6. On the left, click Options.
    "Options" menu option
  7. Under "Danger zone", click Delete this package.
    Delete package version button
  8. To confirm deletion, type the package name and click I understand the consequences, delete this package.
    Confirm package version deletion button

Deleting all versions of an organization-owned container image on GitHub

  1. On GitHub, navigate to the main page of your organization.
  2. Under your organization name, click Packages.
    Container access invite button
  3. Search for and select your package.
  4. In the top right of your container image's landing page, click Package settings.
    Package settings button
  5. On the left, click Options.
    "Options" menu option
  6. Under "Danger zone", click Delete this package.
    Delete package button
  7. To confirm deletion, type the package name and click I understand the consequences, delete this package.
    Confirm package deletion button

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.