Browse by Topic

Importing Product Images

Including product images in your product import is the fastest way to attach images to your products.

You can include product images when importing your products in one of two ways, depending on how they are stored. If the images are already on the internet and you know the URL, you can import them using the image path in the CSV file. If the images are on your computer, we recommend uploading them through WebDAV instead.

Image Requirements

Images must meet the following requirements. Attempting to import or upload an image that does not meet these requirements can cause unexpected behavior.

  • Image file names must be alphanumeric, and cannot contain any spaces or special characters.
  • Image file types must be JPEG/JPG, GIF or PNG. They cannot be TIFF, BMP, or PDF file formats.
  • The optimal size for your product images is 1280 x 1280 pixels. Other product images (like thumbnails) will be created from the original image you upload.

Using the Image Path

If your product images are already online, you can specify the full image path in your CSV file to import them along with your products. See Importing Products for more information on importing products.

1. Locate the column in your CSV for product images. If you are using the Bulk Edit template, this column will be called Product Image File - (#). If you are importing new products, be sure to leave the Product Image ID column blank.

Product Image Columns

 

Be careful! When updated existing products, leaving the Product Image ID and deleting the Product image file from the CSV will remove the image tied to that product upon import.

2. Enter the full path (e.g. http://oldstore.com/images/product-image.png) of the image for each product. Non-http URLs are not supported.

CSV Product Image column containing a full image path

To upload multiple images for a single product, create a new column with a heading of Product Image File - # (increasing the number each time you make a new column). To include any of the other information for that image (e.g. descriptions), make a new column with the appropriate heading and same number as the corresponding image.

CSV showing multiple product image columns

3. When you are ready, import your products.

If using a template other than Bulk Edit, match the Product Image field to the correct column on the Link Import Fields step of the import.

Link Import Field

Uploading through WebDAV

With the upload method, you will upload images from your computer to your store using WebDAV, then specify the image by file name in the CSV.

1. Connect to your store through WebDAV.

2. Open the product_images folder.

product_images folder

3. Open the import folder. Create one if you do not see one.

Import Folder

4. Drag and drop the images from your computer to the import folder.

Import folder containing sample images

5. In your product CSV, locate the column for product images. If you are using the Bulk Edit template, this column is called Product Image File - (#).

Product Image File - 1 in a CSV

6. Enter the file name (e.g. image.png) of the image file.

CSV file with a sample image name in the Product Image File column

 

Be careful! WebDAV is case-sensitive, so make sure that your file names (including the extension) match those in the import folder. Characters are restricted to a-z, 0-9, - and _.

To upload multiple images for a single product, create a new column with a heading of Product Image File - # (increasing the number each time you make a new column). To include any of the other information for that image (e.g. descriptions), make a new column with the appropriate heading and same number as the corresponding image.

CSV showing multiple product image columns

7. When you are ready, import your products.

If using a template other than Bulk Edit, match the Product Image field to the correct column on the Link Import Fields step of the import.

Link import field

Was this article helpful?