Updating, deprecating, and deleting container image products
Stay organized with collections
Save and categorize content based on your preferences.
Updating images in Container Registry
Following the same process that you performed when you pushed your image to your
Container Registry staging repository, add your new image to
Container Registry with the proper tag.
Build the image that you want to push to your Container Registry staging
repository.
Tag your image using Docker with the tag of the existing version you'd like
to update (or with a new tag if you want the image under a new version):
docker tag {image_name} {staging_repo_path}:{tag}
For example,
docker tag test-image gcr.io/testpartner/testsolution:latest
Push your image using gcloud:
gcloud docker push {staging_repo_path}:{tag}
Repeat for any additional tags you'd like to add or update to your
staging repository. Note that a single image can have multiple tags.
Remember that pushing an image to your staging repository doesn't
automatically make it visible to users (even if you use a tag that is
already associated with a version); this only happens after you update the
version in Producer Portal and your product is published.
You can manage tags directly (add, edit, or delete) on images already in
your Container Registry staging repository using the
Container Registry UI.
Replace YOUR_PUBLIC_PROJECT_ID with the ID for the public
project that you created for Cloud Marketplace—for example,
my-organization-public.
In the list of products, click the product ID.
On the Overview page of your product, go to the Container images
section, and click Edit.
By Proposed Releases, click Edit. It might take a few seconds to read the
repository and load your tags.
Click the release that you want to update.
In Display tag, select the version that uses the corresponding
digest to the image you updated in your staging Container Registry repository.
After you've updated all the information for the release, click Done.
When you're done updating supported releases to your product, click Save and Validate.
Click Submit to submit the container images for review.
After all reviews have been approved, you can publish and launch the
product by opening the Overview page of your product and clicking Publish.
Removing versions
When you remove a release from your product, it is immediately removed from
the product details page when the product is published. However, removing
a release does not remove the images published to the public
Container Registry.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Updating, deprecating, and deleting container image products\n\nUpdating images in Container Registry\n-------------------------------------\n\nFollowing the same process that you performed when you pushed your image to your\nContainer Registry staging repository, add your new image to\nContainer Registry with the proper tag.\n\n1. Build the image that you want to push to your Container Registry staging repository.\n2. Tag your image using Docker with the tag of the existing version you'd like\n to update (or with a new tag if you want the image under a new version):\n\n `docker tag {image_name} {staging_repo_path}:{tag}`\n\n For example,\n `docker tag test-image gcr.io/testpartner/testsolution:latest`\n3. Push your image using `gcloud`:\n\n `gcloud docker push {staging_repo_path}:{tag}`\n4. Repeat for any additional tags you'd like to add or update to your\n staging repository. Note that a single image can have multiple tags.\n\n Remember that pushing an image to your staging repository doesn't\n automatically make it visible to users (even if you use a tag that is\n already associated with a version); this only happens after you update the\n version in Producer Portal and your product is published.\n\nYou can manage tags directly (add, edit, or delete) on images already in\nyour Container Registry staging repository using the\n[Container Registry UI](https://cloud.google.com/container-registry/).\n\n### Updating your products in Producer Portal\n\n1. Open Producer Portal in the Google Cloud console:\n\n ```\n https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID\n ```\n\n Replace \u003cvar translate=\"no\"\u003eYOUR_PUBLIC_PROJECT_ID\u003c/var\u003e with the ID for the public\n project that you created for Cloud Marketplace---for example,\n `my-organization-public`.\n | **Note:** If you don't see the link, or can't access the URL, verify that you've selected the correct project and have the Editor (`roles/editor`) role for the project. If you still can't access the URL, use the [Partner Support Desk](https://g.co/cloud/psd-partner) to request assistance, and include the word \"Marketplace\" in your description. For more information about Partner Support Desk, visit [Request assistance with Cloud Marketplace](/marketplace/docs/partners/get-support).\n2. In the list of products, click the product ID.\n\n3. On the **Overview** page of your product, go to the **Container images**\n section, and click **Edit**.\n\n4. By **Proposed Releases** , click **Edit**. It might take a few seconds to read the\n repository and load your tags.\n\n5. Click the release that you want to update.\n\n6. In **Display tag**, select the version that uses the corresponding\n digest to the image you updated in your staging Container Registry repository.\n\n7. After you've updated all the information for the release, click **Done**.\n\n8. When you're done updating supported releases to your product, click **Save and Validate**.\n\n9. Click **Submit** to submit the container images for review.\n\n10. After all reviews have been approved, you can publish and launch the\n product by opening the **Overview** page of your product and clicking **Publish**.\n\nRemoving versions\n-----------------\n\nWhen you remove a release from your product, it is immediately removed from\nthe product details page when the product is published. However, removing\na release does not remove the images published to the public\nContainer Registry.\n\n1. Open Producer Portal in the Google Cloud console:\n\n ```\n https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID\n ```\n\n Replace \u003cvar translate=\"no\"\u003eYOUR_PUBLIC_PROJECT_ID\u003c/var\u003e with the ID for the public\n project that you created for Cloud Marketplace---for example,\n `my-organization-public`.\n | **Note:** If you don't see the link, or can't access the URL, verify that you've selected the correct project and have the Editor (`roles/editor`) role for the project. If you still can't access the URL, use the [Partner Support Desk](https://g.co/cloud/psd-partner) to request assistance, and include the word \"Marketplace\" in your description. For more information about Partner Support Desk, visit [Request assistance with Cloud Marketplace](/marketplace/docs/partners/get-support).\n2. In the list of products, click the product ID.\n\n3. On the **Overview** page of your product, go to the **Container images**\n section, and click **Edit**.\n\n4. By **Proposed Releases** , click **Edit**. It might take a few seconds to read the\n repository and load your tags.\n\n5. Highlight the release that you want to remove.\n\n6. Click delete to remove the version.\n\n7. Click **Done**.\n\n8. When you're done removing releases to your product, click **Save and Validate**.\n\n9. Click **Submit** to submit the container images for review.\n\n10. After all reviews have been approved, you can publish and launch the\n product by opening the **Overview** page of your product, and clicking **Publish**."]]