Product Image Import

How to Import Images

  1. Upload your images to Import & Export > Product Images. For steps, see Uploading Image Files.
  2. In Product Images, open the dropdown in the top-right corner and select Export to CSV For Import. This downloads a spreadsheet with the image paths and the column headers needed for import. See Export Image Paths For CSV Files.
  3. Add a sku column to the spreadsheet so each row links a product to its images, then import the file. Use the Image Path Format rules below for any paths you enter by hand.

Importing Images

There are two main Image types that you can import images to on your products. The CSV column headers below may be added to your product and category import spreadsheets.

ImageDescriptionCSV Column Header
Main ImageThe main image that will appear first and on all product locations in your store (category page, product page, shopping cart, checkout, emails, and featured/new product lists)image
Gallery ImageAlso called "Media Images" These are additional images that will display only on the Product Page below or next to the Main Image._media_image

Image Path Format

❗️

Images uploaded to Product Images must be referenced by their path, not their full link

If the image is already in Import & Export > Product Images, enter its path in the image and _media_image columns. Do not use the full https:// link to that image.

  • Start the path with a forward slash: /
  • Include every folder the image is in.
  • Replace each space in a folder or file name with %20.
  • Match the file name exactly, including capitalization and the file extension.
Where the image isWhat to enterExample
Product Images, main folder/ + file name/blue-widget.jpg
Product Images, inside a folder/ + folders + file name/widgets/blue-widget.jpg
Product Images, file name with a spaceReplace the space with %20/widgets/blue%20widget.jpg
Hosted publicly on another websiteThe full URLhttps://cdn.example.com/images/blue-widget.jpg

A full URL is only for images hosted on another website. Zoey downloads those images into Product Images and sets them on the product.

👍

Use a hyphen or underscore instead of spaces in image and folder names, like blue-widget.jpg. This avoids most image import problems.

The Template

The Images template below has one tab for your main image, and one tab for a second image. You may copy the second image tab as a third, fourth, fifth tab, etc., for any additional images you may have to import.

👍

Click here to download a CSV copy of the template.

Image Import FAQ

The import finished without errors, but the image isn't showing on the product. Why?

The image path in your CSV doesn't match an image in Import & Export > Product Images. Check that the path:

  • starts with /,
  • includes every folder the image is in,
  • uses %20 for each space, and
  • matches the file name exactly, including capitalization and the file extension.

The most common cause is using the full https:// link for an image that's already uploaded to Product Images. Use its path instead, like /widgets/blue-widget.jpg. See Image Path Format.

How do I find the exact path of an uploaded image?

Go to Import & Export > Product Images, open the folder, and click the image to preview it. The File Path shows the full link to the image. Your path is the part after /import.

For example, if the File Path ends in .../media/import/widgets/blue%20widget.jpg, enter /widgets/blue%20widget.jpg in your CSV.

My image name has a space in it. What do I enter?

Replace each space with %20. For blue widget.jpg in the main folder, enter /blue%20widget.jpg. To avoid this, rename the image with a hyphen or underscore before uploading it.

My image is in a folder. Do I need to include the folder?

Yes. Include every folder, starting from the main Product Images folder. For blue-widget.jpg in a widgets folder, enter /widgets/blue-widget.jpg.

Can I use a link to an image on my own website or a CDN?

Yes. Enter the full public URL, like https://cdn.example.com/images/blue-widget.jpg. The image must open in a browser without logging in. Zoey downloads it into Product Images and sets it on the product.


Did this page help you?