You are browsing upcoming documentation for version 6.0 of OroCommerce, OroCRM, and OroPlatform, scheduled for release in 2024. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Settings for Product Images per Website 

You can update the product watermark settings, enable image preview and configure whether to use popup or inline view for the image gallery per website:

  1. Navigate to System > Websites in the main menu.

  2. For the necessary website, hover over the more actions menu to the right of the necessary website and click to start editing the configuration.

  3. Select Commerce > Product > Product Images in the menu to the left.


    For faster navigation between the configuration menu sections, use Quick Search.

  1. Clear the Use Organization checkbox to change the organization-wide setting.

  2. In the General section, configure the following options:

    Enable Original File Names — When enabled, the original image file name will be appended to the system-generated hash value. All non-alphanumeric characters (e.g., “:”, “)”, “,”, “~”) will be replaced with “-” (dash).

    For example, the name of the file is coffee_maker/bosch_#RND123.jpg, the system-generated hash value is “media/cache/attachment/product_gallery_main/5bae287538.jpg”. If the option is enabled, the file name will be displayed in the storefront as follows “media/cache/attachment/product_gallery_main/5bae287538-coffee-maker-bosch-RND123.jpg”

  3. In the Product Image Watermark section, the following options are available:

    • File – The image file with the watermark on a transparent background.

    • Size – The size of the watermark in percentage compared to the whole image.

    • Position – The watermark position on the image (e.g, top left, top, top right, left, right, center, bottom left, bottom, and bottom right).

  4. In the Image Gallery Options section, the following options are available:

    • Enable Image Preview on Product Listing — When this option is enabled, clicking on the product image on the product listing page in the storefront will open a pop up image gallery, rather than the product page.


      When the option is disabled, clicking on the product image on the product listing page in the storefront will open the product page.