Multiple Images in Different Columns

Multiple Image in One Column

✅ Use the Image Column Separator (,) as specified in your feed file. The image above is for reference.

There are a few settings for this field which are:

1. Only add images if the product has no image & Skip existing images and import new images (✔️ Update)

By default, it will only add images if the product has no image. If selected the second option, it will import new instead of the existing images.

2. Export Image Options (✔️ Export)

There are three options available for exporting images. By default, all images will be exported. The second option exports images for each variant; if an image is missing, the product image will be used instead. The last option only exports variant images and ignores any that are blank.

3. Link image to variant when the image url is same row as variant & Assign first product images to all variants

By default, it will update the images that link to variant when the image url is same row as variant. If enabled the assign first product images to all variants, it will update to the first product image to all variants.

4. Image Alt Column Mapping

If Stock Sync could not load or find the images that have been specified in the product images column mapping. Map the Image Alt to display text as a replacement.

5. URL prefix

It helps for adding a URL prefix to every image link. It can use when there are images not specified with domains and only have the file path or filename.

6. Default Image URL

It can set a default image URL when the product has no image in its column. It supports multiple default images separated by a comma.

7. Image column Separator

If images are not uploading even though the URLs are valid, ensure the Image Column Separator matches the delimiter used in your feed. When image URLs contain commas, switching the separator from Auto to a specific character (such as a pipe |) may fix parsing issues.

To specify if the image field uses a different type of column separator. By default, it will use as auto selection.

To specify if the image field uses a different type of column separator. By default, it will use as auto selection.

8. Replace product images

This action will replace all existing images with those from the feed file, matching SKUs with the store. This cannot be undone, and the function will be disabled afterward to prevent unintended image deletion or addition.

Enabling this option skips updates when the feed value is blank. This option is enabled by default.

9. Skip update when feed value is blank (value zero is not blank)

Enabling this option skips updates when the feed value is blank. This option is enabled by default.

Additional notes:

• Image URLs must be directly accessible and may not include restricted-cloud formats (e.g., Azure Blob links showing “Locked” or URLs rejected by Shopify as invalid).
• Feed columns must contain the actual image file URL, not a website page URL or index directory.
• Special characters in URLs (such as the pipe | spaces, and other symbols) can cause Shopify to reject the image upload. These characters cause "Media processing failed" errors because Shopify's importer cannot properly parse the URL string.
• Ensure the correct image column is mapped; if the mapped column contains non-image links, images will not upload.

Troubleshooting Image Issues

• If multiple variants share the same SKU, images may map incorrectly. Ensure each variant has a unique product identifier or include option values in the identifier.
• If image URLs contain characters like + - . they may be cleaned automatically. Enable url_unescape or ensure the feed provides URLs without problematic characters.
• To avoid uploading placeholder images (such as noImage.png), use Find and Replace in the image mapping. Find the placeholder URL and leave Replace empty to skip it.
• If images are not loading despite valid URLs, verify the correct column is mapped (for example, map to Product image URL instead of a page link).

Updated on: 22/05/2026