---
updatedAt: 2026-06-29T20:15:51.000Z
---

# Add rich media

This request adds rich media, or material such as videos, comparison tables, and item-specific view 360 media, to an item. Extract the XSDs for the Rich Media API at the following link: [Rich Media API XSDs](https://developer.walmart.com/image/asdp/us/cp/Rich_Media_XSDs.zip).

You can only upload rich media as an update for an item that has already been ingested.

New item uploads containing rich media will cause that item ingestion to fail. To upload rich media, wait for the item ingestion process to complete successfully, then make a POST call with the rich media content for ingested items.


[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-6511da9b-7282-4d69-bd30-785314d2e4f4?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-6511da9b-7282-4d69-bd30-785314d2e4f4%26entityType%3Dcollection%26workspaceId%3D1f673f2c-8ec6-48f9-8459-003eef27c6ab\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Item Management",
    "description": "Use the Item Management API to set up and manage your items on Walmart.com.",
    "version": "1.0",
    "contact": {
      "name": "contact name"
    }
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api-gateway.walmart.com",
      "description": "Production URL"
    }
  ],
  "tags": [
    {
      "name": "Maintenance Actions",
      "description": "Use the Maintenance Actions endpoints to update and retrieve item attributes."
    }
  ],
  "paths": {
    "/v2/feeds": {
      "post": {
        "tags": [
          "Maintenance Actions"
        ],
        "operationId": "updateRichMediaOfItem",
        "summary": "Add rich media",
        "description": "This request adds rich media, or material such as videos, comparison tables, and item-specific view 360 media, to an item. Extract the XSDs for the Rich Media API at the following link: [Rich Media API XSDs](https://developer.walmart.com/image/asdp/us/cp/Rich_Media_XSDs.zip).\n\nYou can only upload rich media as an update for an item that has already been ingested.\n\nNew item uploads containing rich media will cause that item ingestion to fail. To upload rich media, wait for the item ingestion process to complete successfully, then make a POST call with the rich media content for ingested items.\n",
        "parameters": [
          {
            "name": "feedType",
            "in": "query",
            "description": "Specifies the feed file that will be used and the action the user is intending.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| item | Legacy feed type |\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "required": true,
            "schema": {
              "type": "string",
              "default": "item"
            },
            "example": "item"
          },
          {
            "in": "header",
            "name": "Accept",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Specifies the data type expected in a response sent from the server.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/json | JSON format for data returned in response. |\n| application/xml | XML format for data returned in response. |\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "application/xml"
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Identifier that tracks the consumer request by channel.\n\nUse the consumer channel type received during your onboarding.\n\nContact your system administrator or developer management for your `WM_CONSUMER.CHANNEL.TYPE` value.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "0f3e4dd4-0514-4346-b39d-…"
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Unique identifier for each API call, used to track and debug issues.\n\nUse a randomly generated GUID for this ID.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Access token returned by the [Create access token request](https://developer.walmart.com/suppliers/reference/postcreateanaccesstoken).\n\nThis value is required for token-based authentication.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM…"
          },
          {
            "in": "header",
            "name": "Content-Type",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Specifies the format of request and response body data: JSON, XML, form data, or another data type.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/xml | XML format for request and response body data. |\n| multipart/form-data | Multipart form data format for request and response body data. |\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "application/xml"
          }
        ],
        "requestBody": {
          "description": "Request objects and fields.",
          "content": {
            "application/xml": {
              "schema": {
                "type": "object",
                "properties": {
                  "string": {
                    "type": "string",
                    "description": "Specifies XML data in string format."
                  }
                }
              },
              "example": {
                "string": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<RichMediaFeed xmlns=\"http://walmart.com/\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://walmart.com/ RichMediaFeed.xsd \">\n    <RichMediaFeedHeader>\n        <version>2.1.2</version>\n        <requestId>requestId</requestId>\n        <requestBatchId>requestBatchId</requestBatchId>\n        <feedDate>2001-12-31T12:00:00</feedDate>\n        <mart>WALMART_US</mart>\n    </RichMediaFeedHeader>\n    <RichMedia>\n        <productIdentifiers>\n            <productIdentifier>\n                <productIdType>UPC</productIdType>\n                <productId>815812013182</productId>\n            </productIdentifier>\n        </productIdentifiers>\n        <Modules processMode=\"MERGE\">\n            <view360 provider=\"\">\n                <html-content>html-content</html-content>\n            </view360>\n            <marketing-content provider=\"\">\n                <html-content>html-content</html-content>\n            </marketing-content>\n            <product-tour provider=\"\">\n                <html-content>html-content</html-content>\n            </product-tour>\n            <videos provider=\"\">\n                <video provider=\"\">\n                    <title>title</title>\n                    <description>description</description>\n                    <language>en-US</language>\n                    <closed-caption>\n                        <url>url</url>\n                        <format>webvtt</format>\n                        <language>en-US</language>\n                    </closed-caption>\n                    <age-gate>0</age-gate>\n                    <source-mobile>\n                        <url>url</url>\n                        <width>720</width>\n                        <height>480</height>\n                        <format>mp4</format>\n                        <thumbnail>\n                            <url>url</url>\n                            <format>png</format>\n                            <width>120</width>\n                            <height>100</height>\n                        </thumbnail>\n                        <poster>\n                            <url>url</url>\n                            <format>jpg</format>\n                            <width>720</width>\n                            <height>480</height>\n                        </poster>\n                    </source-mobile>\n                    <sources>\n                        <source>\n                            <url>url</url>\n                            <width>720</width>\n                            <height>480</height>\n                            <format>mp4</format>\n                            <screen>mobile</screen>\n                            <thumbnail>\n                                <url>url</url>\n                                <format>png</format>\n                                <width>120</width>\n                                <height>100</height>\n                            </thumbnail>\n                            <poster>\n                                <url>url</url>\n                                <format>jpg</format>\n                                <width>720</width>\n                                <height>480</height>\n                            </poster>\n                        </source>\n                    </sources>\n                    <duration>0</duration>\n                    <likes>0</likes>\n                    <views>0</views>\n                    <tags>tags</tags>\n                </video>\n            </videos>\n            <documents provider=\"\">\n                <document>\n                    <title>title</title>\n                    <url>url</url>\n                    <format>pdf</format>\n                    <pages>0</pages>\n                    <thumbnail>\n                        <url>url</url>\n                        <format>png</format>\n                        <width>120</width>\n                        <height>100</height>\n                    </thumbnail>\n                    <size>0</size>\n                </document>\n            </documents>\n            <customer-review-videos provider=\"\">\n                <customer-review-video provider=\"\">\n                    <title>title</title>\n                    <description>description</description>\n                    <language>en-US</language>\n                    <closed-caption>\n                        <url>url</url>\n                        <format>webvtt</format>\n                        <language>en-US</language>\n                    </closed-caption>\n                    <age-gate>0</age-gate>\n                    <source-computer>\n                        <url>url</url>\n                        <width>720</width>\n                        <height>480</height>\n                        <format>mp4</format>\n                        <thumbnail>\n                            <url>url</url>\n                            <format>png</format>\n                            <width>120</width>\n                            <height>100</height>\n                        </thumbnail>\n                        <poster>\n                            <url>url</url>\n                            <format>jpg</format>\n                            <width>720</width>\n                            <height>480</height>\n                        </poster>\n                    </source-computer>\n                    <sources>\n                        <source>\n                            <url>url</url>\n                            <width>720</width>\n                            <height>480</height>\n                            <format>mp4</format>\n                            <screen>mobile</screen>\n                            <thumbnail>\n                                <url>url</url>\n                                <format>png</format>\n                                <width>120</width>\n                                <height>100</height>\n                            </thumbnail>\n                            <poster>\n                                <url>url</url>\n                                <format>jpg</format>\n                                <width>720</width>\n                                <height>480</height>\n                            </poster>\n                        </source>\n                    </sources>\n                    <duration>0</duration>\n                    <likes>0</likes>\n                    <views>0</views>\n                    <tags>tags</tags>\n                </customer-review-video>\n            </customer-review-videos>\n            <comparison-table provider=\"\">\n                <headline>\n                    <image>\n                        <title>title</title>\n                        <url>url</url>\n                        <height>0</height>\n                        <width>0</width>\n                        <format>png</format>\n                    </image>\n                </headline>\n                <feature-column>\n                    <sections>\n                        <section>\n                            <header>\n                                <caption>caption</caption>\n                            </header>\n                            <feature>\n                                <caption>caption</caption>\n                            </feature>\n                        </section>\n                    </sections>\n                </feature-column>\n                <product-columns>\n                    <product-column>\n                        <products-info>\n                            <product-info>\n                                <title>title</title>\n                                <thumbnail>\n                                    <url>url</url>\n                                    <format>png</format>\n                                    <width>120</width>\n                                    <height>120</height>\n                                </thumbnail>\n                                <productIdentifiers>\n                                    <productIdentifier>\n                                        <productIdType>UPC</productIdType>\n                                        <productId>productId</productId>\n                                    </productIdentifier>\n                                </productIdentifiers>\n                            </product-info>\n                        </products-info>\n                        <value>value</value>\n                    </product-column>\n                </product-columns>\n            </comparison-table>\n            <expert-reviews provider=\"\">\n                <expert-review provider=\"\">\n                    <html-content>html-content</html-content>\n                </expert-review>\n            </expert-reviews>\n            <misc-modules provider=\"\">\n                <misc-module>\n                    <attributeName>attributeName</attributeName>\n                    <attributeValue>attributeValue</attributeValue>\n                </misc-module>\n            </misc-modules>\n        </Modules>\n        <additionalProductAttributes>\n            <NameValueAttribute>\n                <name>name</name>\n                <type>LOCALIZABLE_TEXT</type>\n                <value>\n                    <value>value</value>\n                    <group>group</group>\n                    <rank>0</rank>\n                </value>\n            </NameValueAttribute>\n        </additionalProductAttributes>\n    </RichMedia>\n</RichMediaFeed>"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "Feed identifier returned by the [POST Maintain Items in Bulk request](https://developer.walmart.com/suppliers/docs/post-maintain-items-in-bulk-how-to-make-bulk-item-submissions-and-track-status), used to track the feed file.",
                      "example": "2D4DB32BC1174C7491720C9EBEB56163@AQMBAAA"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "array",
                      "description": "Array of objects containing error information.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "Error code of the response.",
                            "example": "UNAUTHORIZED.GMP_GATEWAY_API"
                          },
                          "field": {
                            "type": "string",
                            "description": "Specifies which field contains the error.",
                            "example": "UNAUTHORIZED"
                          },
                          "description": {
                            "type": "string",
                            "description": "Description of the error.",
                            "example": "Unauthorized"
                          },
                          "info": {
                            "type": "string",
                            "description": "Information about the error.",
                            "example": "Unauthorized token or incorrect authorization header.\n\nVerify that you are using the correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n"
                          },
                          "severity": {
                            "type": "string",
                            "description": "Severity of the error.",
                            "example": "ERROR"
                          },
                          "category": {
                            "type": "string",
                            "description": "Category of the error.",
                            "example": "DATA"
                          },
                          "causes": {
                            "type": "array",
                            "description": "List of error causes",
                            "items": {
                              "type": "string",
                              "description": "Cause of the error."
                            }
                          },
                          "errorIdentifiers": {
                            "type": "object",
                            "description": "Error identifiers associated with the error."
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "401 - Unauthorized Error": {
                    "value": {
                      "error": [
                        {
                          "code": "UNAUTHORIZED.GMP_GATEWAY_API",
                          "field": "UNAUTHORIZED",
                          "description": "Unauthorized",
                          "info": "Unauthorized token or incorrect authorization header.\n\nVerify that you are using the correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n",
                          "severity": "ERROR",
                          "category": "DATA",
                          "causes": [],
                          "errorIdentifiers": {}
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "1P Suppliers Items Reference",
      "tags": [
        "Get Spec",
        "Item Taxonomy",
        "Item Setup",
        "View Items in Catalog",
        "View Item Catalog in Bulk",
        "Maintenance Actions"
      ]
    }
  ]
}
```