Documentation Commerce Admin Systems Guide

Product image import

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

Beginner
Intermediate
Admin
Leader

Multiple product images of each type can be imported into Adobe Commerce and Magento Open Source 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 Commerce server or external server.

Commerce 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 Commerce manages the directory structure automatically. But 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 Commerce 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 many 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

It is recommended that you use a program that supports UTF-8 encoding to edit CSV files, such as Notepad++. Microsoft® Excel inserts additional characters into the column header of the CSV file, which can prevent the data from being imported back into Commerce.

Method 1: Import images from the local server

On the Commerce server, upload the image files to the var/import/images folder or a subfolder, such as var/import/images/product_images. This is the default root folder for importing product images.

code language-none
`<Magento root folder>/var/import/images`

note note

NOTE

Starting with the Adobe Commerce and Magento Open Source 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 Adobe Commerce and Magento Open Source releases, you can use a different folder on the Commerce server, as long as the path to the folder is specified during the import process.

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).

note note
NOTE
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 {width="600" modal="regular"}

Follow the instructions to import the data.

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

code language-none
`var/import/images`

Data import images file directory {width="600" modal="regular"}

note tip
TIP
Leave Images File Directory blank to use the `<Magento-root-folder>/var/import/images` directory. Beginning with Adobe Commerce and Magento Open Source version 2.3.2, this is the default import images base 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

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

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).

code language-none
`https://example.com/images/image.jpg`

Follow the instructions to import the data.

Method 3: Import images with remote storage

In the Remote storage module, upload the image files to the var/import/images folder or a subfolder, such as var/import/images/product_images. This is the default root folder for importing product images.

code language-bash
`<remote-storage-root-folder>/var/import/images`

note note

NOTE

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

note note
NOTE
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 {width="600" modal="regular"}

Follow the instructions to import the data.

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

code language-none
`var/import/images/product_images`

note tip
TIP
Leave the Images File Directory blank to use the `<Magento-root-folder>/var/import/images` directory. Beginning with Adobe Commerce and Magento Open Source version 2.3.2, this is the default import images base 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: image02.jpg,image03.jpg

For more information about enabling and managing the Remote storage module, see Configure remote storage in the Configuration guide.

NOTE

Importing product images does not initiate image resize. Product images are resized on the frontend by pub/get.php. Make sure that your pub/get.php is working properly; otherwise, images may not be resized.

recommendation-more-help

d3c62084-5181-43fb-bba6-1feb2fcc3ec1