Magento Open Source 2.1.x

Magento 2.1.x Notice: Magento 2.1.18 is the final 2.1.x release. After June 2019, Magento 2.1.x will no longer receive security patches, quality fixes, or documentation updates. To maintain your site's performance, security, and PCIPayment Card Industry: Refers to debit and credit cards and their associated businesses. compliance, upgrade to the latest version of Magento. The Magento User Guide 2.1.x remains available in PDF for Open Source and Commerce.

Uploading Product Images

For each product, you can upload multiple images, rearrange their order mages, and control how each image is used. If you have a large quantity of images to manage, you might prefer to import them as a batch, rather than upload each one individually. To learn more, see: Importing Product Images.

To manage images:

1. Open the product in edit mode. Scroll down and expand the Images and Videos section. Then, do any of the following:
2. Tap the image that you want to open in detail view: Then, do any of the following:

Image Detail View
3. To close detail view, click the Close () box in the upper-right corner.
4. When complete, tap  Save 
  • Image Roles

    Image Role



    Thumbnail images appear in the thumbnail gallery, shopping cart, and in some blocks such as Related Items.

    Example size: 50 x 50 pixels

    Small Image

    The small image is used for the product images in listings on category and search results pages, and to display the product images needed for sections such as for Up-sells, Cross-sells, and the New Products List.

    Example size: 470 x 470 pixels

    Base Image

    The base image is the main image on the product detail page. Image zoom is activated if you upload an image that is larger image than the image container. Example sizes:

    470 x 470 pixels (without Zoom)
    1100 x 1100 pixels (with Zoom)


    A swatch can be used to illustrate the color, pattern, or texture. Example size: 50 x 50 pixels