Merge pull request #22056 from docker/published-update

publish updates from main

Author: craig-osterhout

content/manuals/docker-hub/release-notes.md

@@ -15,6 +15,12 @@ known issues for each Docker Hub release.
 
 Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projects/51/views/1?filterQuery=) to see what's coming next.
 
+## 2025-02-18
+
+### New
+
+- You can delete images and image indexes using [Image Management](./repos/manage/hub-images/manage.md).
+
 ## 2024-12-12
 
 ### New

content/manuals/docker-hub/repos/manage/hub-images/_index.md

@@ -12,9 +12,12 @@ version-controlled, and easy to share. This section covers key image management
 tasks, including tagging, pushing images, transferring images between
 repositories, and supported software artifacts.
 
+
 - [Tags](./tags.md): Tags help you version and organize different iterations of
   your images within a single repository. This topic explains tagging and
   provides guidance on how to create, view, and delete tags in Docker Hub.
+- [Image Management](./manage.md): Manage your images and image indexes to
+  optimize your repository storage.
 - [Software artifacts](./oci-artifacts.md): Docker Hub supports OCI (Open
   Container Initiative) artifacts, allowing you to store, manage, and distribute
   a range of content beyond standard Docker images, including Helm charts,

content/manuals/docker-hub/repos/manage/hub-images/images/image-index.svg

@@ -0,0 +1,52 @@
+---
+description: Discover how to delete image tags.
+keywords: Docker Hub, Hub, tags, delete
+title: Image Management
+linktitle: Image Management
+weight: 12
+---
+
+{{< summary-bar feature_name="Image management" >}}
+
+Images and image indexes are the foundation of container images within a
+repository. The following diagram shows the relationship between images and
+image indexes.
+
+  ![a pretty wide image](./images/image-index.svg)
+
+This structure enables multi-architecture support through a single reference. It
+is important to note that images are not always referenced by an image index.
+The following objects are shown in the diagram.
+
+- Image index: An image that points to multiple architecture-specific images
+  (like AMD and ARM), letting a single reference work across different
+  platforms.
+- Image: Individual container images that contain the actual configuration and
+  layers for a specific architecture and operating system.
+
+## Manage repository images and image indexes
+
+1. Sign in to [Docker Hub](https://hub.docker.com).
+2. Select **Repositories**.
+3. In the list, select a repository.
+4. Select **Image Management**.
+5. Search, filter, or sort the items.
+   - Search: In the search box above the list, specify your search.
+   - Filter: In the **Filter by** drop-down, select **Tagged**, **Image index**,
+     or **Image**.
+   - Sort: Select the column title for **Size**, **Last pushed**, or **Last
+     pulled**.
+
+   > [!NOTE]
+   >
+   > Images that haven't been pulled in over 6 months are marked as **Stale** in
+   > the **Status** column.
+
+6. Optional. Delete one or more items.
+   1. Select the checkboxes next to the items in the list. Selecting any
+      top-level index also removes any underlying images that aren't referenced
+      elsewhere.
+   2. Select **Preview and delete**.
+   3. In the window that appears, verify the items that will be deleted and the
+      amount of storage you will reclaim.
+   4. Select **Delete forever**.

content/manuals/docker-hub/repos/manage/hub-images/manage.md

@@ -33,8 +33,8 @@ both individuals and organizations:
 
 4. Optimize your storage by:
 
-    - Regularly auditing and removing repositories with untagged, unused, or outdated images.
-    - Looking for private repositories in Hub storage that exceed your plan's limits.
+    - Regularly auditing and [removing entire repositories](../repos/delete.md) with untagged, unused, or outdated images.
+    - Using [Image Management](../repos/manage/hub-images/manage.md) to remove stale and outdated images within a repository.
 
 5. Increase your limits by upgrading or purchasing additional consumption. For
    details, see [Scale your subscription](/manuals/subscription/scale.md).

content/manuals/docker-hub/usage/manage.md

@@ -150,6 +150,8 @@ GitHub Actions cache:
 Hardened Docker Desktop:
   subscription: [Business]
   for: Administrators
+Image management:
+  availability: Beta
 Import builds:
   availability: Beta
   requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later