Enable image resizing

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Advanced and choose System.

  3. Expand Expansion selector the Images Upload Configuration section.

    To change default settings, deselect the Use system value checkbox if needed.

    Image Upload Configuration

    For a detailed list of these configuration settings, see Image Upload Configuration in the Configuration Reference.

  4. To enable, make sure Enable Frontend Resize is set to Yes.

  5. Enter a Quality setting between 1 and 100%.

    A setting between 80-90% is recommended for a reduced file size and high quality.

  6. Set the Maximum Width in pixels for the image.

    When the image is resized, it does not exceed this width and retains proportions.

  7. Set the Maximum Height in pixels for the image.

    When the image is resized, it does not exceed this height and retains proportions.

  8. When complete, click Save Config.

Field descriptions

FieldScopeDescription
QualityGlobalDetermines the JPG quality for the resized image. Lower quality reduces the file size. 80-90% is recommended to help reduce file size with high quality. Default: 80
Enable Frontend ResizeGlobalAllows Commerce to resize large, oversized images you may upload for the Product Details page. Commerce resizes the image files using JavaScript when uploading the file. When the image is resized, it keeps the exact proportions, to meet and not exceed the largest size for Maximum Width or Maximum Height. Default: Yes
Maximum WidthGlobalDetermines the maximum pixel width for the image. When the image is resized, it does not exceed this width. Default: 1920
Maximum HeightGlobalDetermines the maximum pixel height for the image. When the image is resized, it does not exceed this height. Default: 1200

Image placeholders

Adobe Commerce and Magento Open Source use temporary images as placeholders until the permanent product images become available. A different placeholder can be uploaded for each role. The initial placeholder image is a sample logo, which you can replace with the image of your choice.

Image Placeholder

To upload placeholder images:

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Catalog and choose Catalog underneath.

  3. Expand Expansion icon the Product Image Placeholders section.

    Product Image Placeholders

    For a detailed list of these configuration settings, see Product Image Placeholders in the Configuration Reference.

  4. For each image role, click Choose File, find the image on your computer, and upload the file.

    You can use the same image for all three roles, or you can upload a different placeholder image for each role.

  5. When complete, click Save.

For information about image roles and recommended sizes, see Upload an image.

Previous pageCatalog images and videos
Next pageManage product images

Commerce