Deleting a container image

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.

Reserved package versions and names

Public packages: To prevent confusion and build problems, GitHub permanently reserves a package's name and version number. Even if an entire package is deleted, you cannot reuse the deleted package name in any repository owned by the same account.

Private packages: If all versions of a private package are deleted, you can publish a package with a previously used name and version.

To revise or replace a package version, we recommend you publish a new version of your package.

Deleting a version 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.
   
3. On your profile page, in the top right, click Packages.
   
4. Search for and select your package.
5. In the top right of your container image's landing page, click Package settings.
   
6. On the left, click Manage versions.
7. To the right of the version you want to delete, click Delete.
   
8. To confirm deletion, type the package name and click I understand the consequences, delete this version.
   

Deleting a version 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.
   
3. Search for and select your package.
4. In the top right of your container image's landing page, click Package settings.
   
5. On the left, click Manage versions.
6. To the right of the version you want to delete, click Delete.
   
7. To confirm deletion, type the package name and click I understand the consequences, delete this version.