Deleting a container image

You can delete a version of a private container image using GraphQL or 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

Did this doc help you?

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.

Note: GitHub Container Registry is currently in public beta and subject to change. Currently, GitHub Container Registry only supports Docker image formats. During the beta, storage and bandwidth is free. For more information, see "About GitHub Container Registry."

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.
    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. To the right of the version you want to delete, click Delete.
    Delete package button
  8. 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

  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. To the right of the version you want to delete, click Delete.
    Delete package button
  7. To confirm deletion, type the package name and click I understand the consequences, delete this version.
    Confirm package deletion button

Did this doc help you?

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.