Magento Open Source, 1.9.x

Magento 1.x Security Patch Notice
For Magento Open Source 1.5 to 1.9, Magento is providing software security patches through June 2020 to ensure those sites remain secure and compliant. Visit our information page for more details about our software maintenance policy and other considerations for your business.

Image Size and Type

As a best practice, you should standardize the size of your images so they appear at the highest possible resolution. A single product image can be displayed in several different sizes throughout your catalog. In addition to the main image on the product page, there are smaller images and thumbnails.

Image types are used in different places in your catalog. If you have only one product image, you can use the same image for each type. If you do not assign an image to each type, a placeholder image is used to mark its place in the catalog.

To configure product images:

1. On the Admin menu, select System > Configuration. Then in the panel on the left under Catalog, select Catalog.
2. Click to expand the Product Image section, and do the following:
a. In the Base Image Width field, enter the maximum width that the base image is to be rendered.
b. In the Small Image Width field, enter the maximum width that the small image is to be rendered.
3. When complete, click the Save Config button.
  • Image Types

    Image Type



    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)

    Media Image

    (Optional) A media image gives you the ability to associate additional images with a product, that are other than a product image. For example, you might include the product logo, care instructions, or an image of the ingredients from a food label.

    If you add a media image attribute to the attribute set of a product, it is listed as an additional image type, along with Base, Small, and Thumbnail. You can set it to "Exclude" so it doesn't appear in the gallery.