After July 2021, the 2.3.x release line will no longer receive quality updates, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x to help maintain PCI compliance.

Importing Product Images

The information on this page is intended for Adobe Commerce 2.3 customers who are on an extended support contract. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Multiple product images of each type can be imported into Magento, and associated with a specific product. The path and file name of each product image is entered in the CSV file, and the image files to be imported are uploaded to the corresponding path on the Magento server or external server.

Magento creates its own directory structure for product images that is organized alphabetically. When you export product data with existing images to a CSV file, you can see the alphabetized path before the file name of each image. However, when you import new images, you do not need to specify a path, because Magento manages the directory structure automatically. Just make sure to enter the relative path to the import directory before the file name of each image to be imported.

To upload images, you must have login credentials and correct permissions to access to the Magento folder on the server. With the correct credentials, you can use any SFTP utility to upload the files from your desktop computer to the server.

Before you try to import a large amount of images, review the steps in the import method that you want to use, and run through the process with a few products. After you understand how it works, you’ll feel confident importing large quantities of images.

Important! We recommend that you use a program that supports UTF-8 encoding to edit CSV files, such as Notepad++ or OpenOffice Calc. Microsoft Excel inserts additional characters into the column header of the CSV file, which can prevent the data from being imported back into Magento.

Method 1: Import Images from the Local Server

  1. On the Magento server, upload the image files to the var/import/images folder. This is the default folder for importing product images.

     <Magento root folder>/var/import/images

    Starting with the Magento 2.3.2 release, the path specified in the Images File Directory concatenates for import to the images base directory - <Magento root folder>/var/import/images. For earlier Magento releases, you can use a different folder on the Magento server, as long as the path to the folder is specified during the import process.

  2. In the CSV data, enter the name of each image file to be imported on the correct row, by sku, and in the correct column according to image type (base_image, small_image, thumbnail_image, or additional_images).

    For images in the default import folder (var/import/images), do not include the path before the filename in the CSV data.

    The CSV file must include only the sku column and the related image columns.

    Example - CSV image data import CSV Import Image from Default Location

  3. Follow the instructions to import the data.

  4. After selecting the file to import, enter the relative path following Images File Directory:


    Leave Images File Directory empty if you are running the import on Magento 2.3.2/2.3.2-p2/2.3.3/2.3.4 versions and files were uploaded into import images base directory - <Magento root folder>/var/import/images.

    Data import images file directory Images File Directory

    If importing multiple images for a single sku, insert the images in a column named additional_images (add the column if not already added), separated by commas. Example: image02.jpg,image03.jpg

Method 2: Import Images from External Server

  1. Upload the images to be imported to the designated folder on the external server.

  2. In the CSV data, enter the full URL for each image file in the correct column by image type (base_image, small_image, thumbnail_image, or additional_images).
  3. Follow the instructions to import the data.