---
name: Registry-ts_manifest_error_version
title: Resolving manifest version errors in IBM Cloud registry
description: 'When you try to tag your image in IBM Cloud® Container Registry, you get a manifest version error: `CRI0301E The manifest version for this image is not supported for tagging.`'
last-updated: 2026-08-04
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/Registry?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Resolving manifest version errors in IBM Cloud registry
{: #troubleshoot-manifest-error-version}
{: troubleshoot}
{: support}

When you try to tag your image in IBM Cloud® Container Registry, you get a manifest version error: `CRI0301E The manifest version for this image is not supported for tagging.`
{: shortdesc}

You tried to tag your image, but you get the following error message: `CRI0301E The manifest version for this image is not supported for tagging. To upgrade to a supported manifest version, pull and push this image by using Docker version 17.07 or later, then run the 'ibmcloud cr image-tag' command again.`
{: tsSymptoms}

The manifest version is not supported.
{: tsCauses}

To resolve the problem, complete the following steps:
{: tsResolve}

1. Upgrade to a supported version of Docker, see [Support for Docker](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_overview&format=markdown#docker).

2. Pull the image that you tried to tag by running the following command, where `SOURCE_IMAGE` is your source image name:

    ```txt
    docker pull SOURCE_IMAGE
    ```
    {: pre}

3. To upgrade the manifest version, push the image by running the following command:

    ```txt
    docker push SOURCE_IMAGE
    ```
    {: pre}

4. Tag the image by running the `ibmcloud cr image-tag` command, see [Creating new images that refer to a source image](https://cloud.ibm.com/docs/Registry?topic=Registry-registry_images_&format=markdown#registry_images_source).