Documentation

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_links attribute is not supported on those platforms. If you are configuring a catalog for them, you must use additional_image_link instead.

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 Check
<g:additional_image_links>

Checking 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:// or https:// 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

FAQ

How do I format multiple image URLs in a CSV feed for Reddit?
You must use a JSON-encoded list of URLs. To avoid breaking the CSV format, the entire list must be wrapped in double quotes, and the internal JSON quotes must be escaped by doubling them (e.g., "[""url1"",""url2""]").
What is the maximum character limit for this attribute?
The Reddit Products platform limits the entire additional_image_links string to a maximum of 2,000 characters.
Do other platforms support this exact attribute name?
No, platforms likeGoogle Merchant Products and Facebook Products use the singular additional_image_link variant instead.

Have thousands of products? Don't check them manually. Upload your file and find errors in 30 seconds.

Try Validator
Last updated: 19 March, 2026