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."
- On GitHub, navigate to the main page of your user account.
- In the top right corner of GitHub, click your profile photo, then click Your profile.
- On your profile page, in the top right, click Packages.
- Search for and select your package.
- In the top right of your container image's landing page, click Package settings.
- On the left, click Manage versions.
- Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select All.
- To the right of the version you want to delete, click and select Delete version.
- 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
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."
- On GitHub, navigate to the main page of your organization.
- Under your organization name, click Packages.
- Search for and select your package.
- In the top right of your container image's landing page, click Package settings.
- On the left, click Manage versions.
- Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select All.
- To the right of the version you want to delete, click and select Delete version.
- To confirm deletion, type the package name and click I understand the consequences, delete this version.
Deleting all versions of a user-owned container image on GitHub
- On GitHub, navigate to the main page of your user account.
- In the top right corner of GitHub, click your profile photo, then click Your profile.
- On your profile page, in the top right, click Packages.
- Search for and select your package.
- In the top right of your container image's landing page, click Package settings.
- On the left, click Options.
- Under "Danger zone", click Delete this package.
- To confirm deletion, type the package name and click I understand the consequences, delete this package.
Deleting all versions of an organization-owned container image on GitHub
- On GitHub, navigate to the main page of your organization.
- Under your organization name, click Packages.
- Search for and select your package.
- In the top right of your container image's landing page, click Package settings.
- On the left, click Options.
- Under "Danger zone", click Delete this package.
- To confirm deletion, type the package name and click I understand the consequences, delete this package.