Additional Image Link Attribute

The additional_image_link attribute allows you to provide more images for your product beyond the primary main image. It is an optional but highly recommended field across Google Merchant Products , Facebook Products ,Pinterest Products , and Tiktok Products to show products from different angles, in-use, or with staging elements.

Submitting correctly formatted, high-quality additional images can significantly boost conversion rates, but formatting requirements vary depending on the platform and file type (CSV vs. XML).

⚠️ Platform Variant Warning: The Reddit Products platform uses a slightly different attribute name for additional images. The additional_image_link attribute is not supported on Reddit. If you are configuring a catalog for Reddit, you must use additional_image_links instead.

Contents:

• Online Validator
• Platform Comparison
• General Requirements
• Formatting Examples

Quick Syntax Check

Paste your <g:additional_image_link> XML snippet or CSV value below to validate the format:

Platform Requirements Comparison

While the fundamental purpose of the attribute is the same, each platform has distinct limitations on quantity, file size, and CSV formatting.

General Formatting Requirements

To ensure your additional images process successfully across all advertising channels, follow these strict rules:

• URL Specifications: Links must begin with http:// or https:// and must be fully encoded (RFC 3986 or RFC 2396 compliant). Ensure your servers allow user-agents to crawl the images.
• Character Limits: The maximum length for the URL string is typically 2,000 characters per platform.
• XML Repetition: When using XML feeds, do not put multiple URLs inside a single tag. You must repeat the XML tag for each additional image.
• CSV Escaping: When working with CSVs, commas within a single URL must be encoded as %2C. The comma used to separate different URLs must not be encoded, but the entire list must be wrapped in double quotes.
• AI Metadata: Do not remove embedded metadata tags (like the IPTC DigitalSourceType property) from images created using generative AI tools. Platforms like Google and TikTok strictly require this.

Formatting Examples

XML Feed Format

Correct Formatting: Use repeated tags for each individual image. Note that the Facebook Products platform allows dropping the g: prefix for this attribute, though the g: prefix is standard for Google.

<g:additional_image_link>https://www.example.com/image2.jpg</g:additional_image_link>
<g:additional_image_link>https://www.example.com/image3.jpg</g:additional_image_link>

Incorrect Formatting: Never place comma-separated lists inside a single XML tag. This will result in a broken, unresolvable URL.

<!-- Incorrect: Multiple URLs submitted inside a single XML tag -->
<g:additional_image_link>https://www.example.com/img2.jpg, https://www.example.com/img3.jpg</g:additional_image_link>

CSV / TSV Feed Format

When working with CSV files, keep the formatting precise to avoid breaking your data columns.

Correct Formatting: You must separate URLs with a comma and wrap the entire string in double quotes. This ensures the parser does not split your data into new columns.

id,title,price,additional_image_link
1234,Premium T-Shirt,24.99 USD,"https://www.example.com/img2.jpg,https://www.example.com/img3.jpg"

Incorrect Formatting: If you fail to wrap comma-separated URLs in quotes, the CSV parser will treat the second URL as a completely new column, breaking the entire row.

id,title,price,additional_image_link
1234,Premium T-Shirt,24.99 USD,https://www.example.com/img2.jpg,https://www.example.com/img3.jpg