Additional Image Links Attribute
The additional_image_links attribute is specifically used to provide additional product images in catalog feeds. Submitting high-quality extra images gives users a better sense of your product, allowing them to see different angles or variations, which can help increase ad engagement and conversion rates.
⚠️ Platform Variant Warning: Platforms like Google Merchant Products , Facebook Products , Pinterest Products , and Tiktok Products use a slightly different attribute name for additional images. The
additional_image_linksattribute is not supported on those platforms. If you are configuring a catalog for them, you must useadditional_image_linkinstead.
Contents:
Quick Syntax Check
Paste your <additional_image_links> XML snippet or CSV value below to validate the format:
Test your <g:additional_image_links>
Live CheckChecking one by one? Validate your entire feed instantly.
Upload & Analyze File →
Platform Requirements Comparison
This comparative table highlights the differences between the platforms. Note that most platforms rely on a singular variant for this attribute.
| Requirement | Google Merchant Products | Facebook Products | Pinterest Products | Tiktok Products | Reddit Products |
|---|---|---|---|---|---|
| XML Tag | Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
<additional_image_links> |
| Max Images | Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not explicitly capped (Max 2,000 chars total) |
| CSV Delimiter | Not supported. Use additional_image_link |
Not supported. Use additional_image_link |
Not supported. Use additional_image_link |
Not supported. Use additional_image_link |
JSON-encoded list ["url1","url2"] |
| Supported Formats | Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
JPG, PNG |
| Min Dimensions | Not supported. Use additional_image_link |
Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
500x500 pixels |
| Max File Size | Not supported. Use additional_image_link |
Not supported. Use additional_image_link |
Not supported. Useadditional_image_link |
Not supported. Use additional_image_link |
20 MB |
General Formatting Requirements
To ensure your additional images process successfully for the Reddit Products catalog, follow these strict rules:
- URL Specifications: Links must begin with
http://orhttps://and must be fully encoded. Ensure your servers allow the URLs to be crawled. - JSON-Encoded List: Unlike other platforms that use simple comma-separated strings, you must format your list of URLs as a valid JSON array.
- Character Limits: The maximum length for the entire URL string is 2,000 characters. If your list of images exceeds this limit, the feed may fail to process the product.
- File Requirements: Images must be a minimum of 500x500 pixels, under 20 MB in size, and in either JPG or PNG format.
Formatting Examples
Because platforms likeGoogle Merchant Products and Facebook Products use a variant attribute, the following examples apply only to theReddit Products platform.
XML Feed Format
Correct Formatting: When using RSS 2.0 XML for Reddit, provide the JSON-encoded list directly inside the tag as a string.
<additional_image_links>["https://www.example.com/image2.jpg","https://www.example.com/image3.jpg"]</additional_image_links>
Incorrect Formatting: Do not use standard comma-separated lists or repeat the XML tag, as the platform expects a single JSON array for this specific attribute.
<additional_image_links>https://www.example.com/img2.jpg, https://www.example.com/img3.jpg</additional_image_links>
CSV / TSV Feed Format
When working with CSV files, you must combine the JSON array requirement with standard CSV escaping rules. Because JSON relies on double quotes, you must double them up "" to escape them properly within the CSV column.
Correct Formatting: The entire JSON string is wrapped in a set of outer double quotes, and every internal double quote is duplicated.
id,title,price,additional_image_links
1234,Premium T-Shirt,24.99 USD,"[""https://www.example.com/img2.jpg"",""https://www.example.com/img3.jpg""]"
Incorrect Formatting: Failing to wrap the URLs in a JSON array, or failing to properly escape the quotes, will break the CSV parser or result in a feed error.
id,title,price,additional_image_links
1234,Premium T-Shirt,24.99 USD,https://www.example.com/img2.jpg,https://www.example.com/img3.jpg