WooCommerce CSV images not importing: check URLs, mapping and access

Identify what the URL actually returns

Open the supplier’s link without relying on a signed-in session. Is it an image, a sharing page, an expired link or an access-denied response? Request a stable direct image URL when the source is a document-sharing service. Do not make private customer documents public to satisfy the importer.

The image host may apply access rules, request limits or hotlink protection. Record one failing URL, the time and the importer’s error message. Ask the host owner to investigate that request instead of disabling security controls across the store. A URL-format check alone cannot diagnose an HTTP failure.

Keep a gallery inside one CSV cell

Inspect the file in a text editor as well as a spreadsheet. A gallery field contains multiple image references, so the CSV writer must quote that field. Otherwise the second URL may become the next column and shift every later value.

Use an export from a correctly configured product as your mapping reference. Confirm that the source image field maps to Images. If you are referring to existing media, verify the actual filenames and the importer’s supported lookup behavior in the core documentation.

Test ordering and failure handling

Use one product with two small images that you control. Check the featured image and gallery separately after importing. Record whether an existing image was reused or a new attachment was created, especially if you plan to repeat the import.

The example uses example.test, a placeholder domain that will not supply images. Replace it with your own permitted image URLs only in staging. Our file preflight does not fetch images, and the downloadable catalog fixture does not test image retrieval. Add meaningful alternative text in the media workflow; the core CSV importer does not provide an image-alt-text import field.

Inspect the CSV structure

Formatting example only. These placeholder URLs are not downloadable images.

SKU,Images
00041,"https://example.test/mug-front.jpg, https://example.test/mug-back.jpg"

Check the result

• The store can retrieve the selected images without a browser login.
• The intended featured image and gallery order appear on the product.
• A failed image is logged and accounted for before the next batch.