Import Product Images and Galleries

WooCommerce products use a featured image (main product image) and an optional product gallery. Import WP can download images from remote URLs, local paths, FTP, or reuse items already in the Media Library.

Image imports are one of the most common WooCommerce support topics — especially remote URL downloads, galleries not attaching, and duplicate images on update.

Which section should I use?

For most product imports, map images in Product Gallery.

Note: Advanced → Is Featured is the WooCommerce “featured product” catalogue flag (starred product). It is not the featured image. Featured images are controlled by Is Featured? on an image/attachment row.

Example CSV

Map the Product Gallery

1. Open the Product Gallery section.
2. Set Location to your images column (comma-separated URLs or paths).
3. Choose the download / location method (Remote URL, Local filesystem, FTP, or Media Library search).
4. Set Is Featured? = Yes so the first image becomes the main product image. Remaining images are added to the gallery.
5. Optionally enable Enable Meta to map alt text and title.

Multiple images in one cell must be separated with a comma (or your configured delimiter). The same delimiter applies to matching meta columns (titles, alt text).

Featured image vs gallery

When a Product Gallery row has Is Featured? = Yes, that image is set as the featured image and included in the gallery ID list.

Image meta (alt text and title)

Enable Enable Meta on the gallery/attachment row, then map:

• Alt Text
• Title Text

Keep the number of meta values aligned with the number of image URLs when importing multiple images in one field.

Download behaviour and duplicates

Attachment rows include permissions / download options such as:

• Always download new files — creates a new Media Library item each run (can duplicate images)
• Search media library (hash / filename based) — reuses an existing attachment when possible

Recommendations:

• For scheduled updates of the same catalogue, prefer searching the Media Library so the same image is not downloaded repeatedly.
• If the same image URL is used on many products, Media Library search helps attach one file to multiple products instead of uploading copies.
• Soft-deleted / “Delete unused records” behaviour can remove media in some setups — test on staging before bulk-deleting products with media cleanup enabled.

Variation images

To set an image on a product variation:

1. Import the variation row as Product Type variation.
2. Map an image on that variation (Product Gallery or Images & Attachments with Is Featured? = Yes).

Parent gallery images are separate from per-variation images.

External image URLs (no Media Library upload)

By default Import WP downloads remote images into the WordPress Media Library (recommended for most stores).

If you need to store external URLs without uploading files (hotlinking / external featured image plugins), that usually requires an extra plugin or custom field mapping rather than the standard Product Gallery download flow. Confirm compatibility before purchase if this is a hard requirement.

Common problems