Quick Rule Summary · Updated November 2026

Shopify Product CSVs accept only one public https:// URL per cell inside Product image URL. To attach multiple gallery photos to one product, create vertical continuation rows sharing the exact same URL handle with Title, Option1 value, and Price left blank and Image position numbered 1, 2, 3….

01 / INTERACTIVE MULTI-IMAGE EXPANDERTurn a multi-URL cell into valid Shopify CSV rows.

Shopify rejects cells containing comma-separated URLs like https://.../1.jpg, https://.../2.jpg with an Invalid URL error because each row’s Product image URL accepts only one public HTTPS link. Paste a multi-URL list or test a preset below to see the exact row structure:

3 image URLs → 3 Shopify CSV rows Notice how (blank) cells keep extra photos from creating ghost variants →
Bulk-split a whole file in Workspace ↗

02 / THE GALLERY CONTINUATION RULEWhy extra image rows must leave Option and Price cells blank.

When a product has more gallery photos than variants (for example, 1 simple SKU with 4 photos, or 2 sizes with 5 photos), the extra rows underneath are image-only continuation rows:

  1. Repeat the exact URL handle on consecutive rows: Every photo belonging to qa-canvas-weekender must sit in an unbroken block sharing that exact lowercase handle.
  2. Fill only the three gallery columns on extra photo rows: On image-only rows, populate URL handle, Product image URL (legacy Image Src), Image position (2, 3, 4…), and optional Image alt text—leaving Title, Description, Option1 value, SKU, and Price completely empty.
  3. When variants AND gallery images overlap: If a shirt has 3 sizes (Small, Medium, Large) and 5 gallery photos, put Gallery Photo 1–3 alongside Variant Rows 1–3, then add Rows 4–5 underneath as image-only continuation rows with blank option and price cells.

03 / GALLERY VS. SWATCH COLUMNProduct image URL vs. Variant image URL.

Shopify’s product CSV has two separate image URL columns that serve different storefront jobs:

Difference between Shopify’s Product image URL and Variant image URL columns
Canonical column (Legacy alias)What it controls on your storefrontFormatting rules
Product image URL
(Legacy: Image Src)
Uploads photos into the main product media gallery carousel in the order set by Image position (1 = featured thumbnail).One direct, publicly reachable https:// image file URL per row; do not repeat the exact same gallery URL across every size row unless needed.
Variant image URL
(Legacy: Variant Image)
Links a specific color/style variant row to the photo shown when a shopper clicks that swatch (e.g., switching from Navy to Olive).Must appear on a sellable variant row (cannot sit alone on an image-only row), and the same URL should also exist in the product’s gallery.
Image positionControls display order (1, 2, 3…) inside the product media gallery.Plain integer (1 is the primary collection card image); keep sequential per handle.
Image alt textScreen-reader accessibility description and Google Image Search caption for the gallery image on that row.Plain descriptive text (up to 512 characters recommended) paired with Product image URL on the same row.

04 / BULK SPLITTING FULL CATALOGSSplit thousands of multi-URL supplier cells in Row & Record.

If your supplier, WooCommerce, or Etsy export has hundreds of products with comma-separated URLs in one column, you don’t need Excel macros or Python scripts:

  1. Load your UTF-8 CSV in the Row & Record Workspace: Files up to 10 MB and 50,000 source records run strictly in browser tab memory—zero data is uploaded.
  2. Map your image column to Product image URL: During the Mapping step, enable Split comma-separated image URLs into image records.
  3. Inspect Target Preview before downloading: Verify the generated continuation rows, confirm no duplicate headers or blank variant prices remain, and export your clean Shopify CSV (or keep our Chrome Extension ↗ pinned for preflight checks).

Check Google Drive & Dropbox links before importing. Viewer links like drive.google.com/file/d/.../view or dropbox.com/...?dl=0 return an HTML webpage instead of raw JPEG/PNG/WebP bytes, causing Shopify’s media downloader to fail. Host images on a direct HTTPS CDN or public server until Shopify finishes re-hosting them.

Common questions.

Can I put multiple image URLs separated by commas in one Shopify CSV cell?

No. Shopify’s Product image URL (Image Src) column accepts only one direct HTTPS URL per row. Putting comma-separated URLs in a single cell triggers an Invalid URL error during import—each additional image must sit on its own row sharing the same URL handle.

Why did adding extra image rows create duplicate $0.00 variants in Shopify?

If you copy Option1 value (or Title and Price) down onto your extra image rows, Shopify treats each row as a brand-new product or variant. On image-only continuation rows, fill only URL handle, Product image URL, Image position, and Image alt text, leaving Title, Option values, SKU, and Price completely blank.

Does Shopify link to my old server forever or re-host imported CSV images?

During CSV import, Shopify fetches each public HTTPS image URL once and copies the image file onto Shopify’s own CDN (cdn.shopify.com). Keep your source image server publicly accessible without password or hotlink protection until the background import email confirms completion.

What image formats and file sizes does Shopify’s product CSV support?

Shopify supports JPEG, PNG, WebP, HEIC, and GIF product images up to 20 MB and 20 megapixels (up to 5000 x 5000 px recommended; 2048 x 2048 px is standard for square zoomable product photography).

RELATED CSV TOOLSRelated gallery & platform CSV tools

Have a supplier sheet with multi-image cells?

Split multi-URL cells into clean Shopify continuation rows locally in your browser.

Open CSV Preflight Workspace ↗

Verified November 2026 against Shopify’s Product CSV media rules and Row & Record’s local multi-image splitter.

Shopify CSV image preparation guideShopify product CSV column referenceRow & Record Chrome Extension ↗