Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

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

Image Resizing and Watermarks

Images.yml provides configuration for image manipulations.

Specify image preset sizes and apply watermarks to images with dimensions configuration.

Enable users to upload different types of product images that will be displayed in different pages with types configuration.

Note

From the back-office, a user can upload image types from all the themes available in the system.

Configuration

Images configuration file should be placed in the layout/{theme_name}/config folder and named images.yml, for example DemoBundle/Resources/views/layouts/first_theme/config/images.yml

Example:

#DemoBundle/Resources/views/layouts/first_theme/config/images.yml
dimensions:
    product_original:
        width: ~
        height: ~
        options:
            applyProductImageWatermark: true
    product_gallery_popup:
        width: 610
        height: 610
        options:
            applyProductImageWatermark: true
types:
    main:
        label: oro.product.productimage.type.main.label
        dimensions:
            - product_original
        max_number: 1
    listing:
        label: oro.product.productimage.type.listing.label
        dimensions:
            - product_original
            - product_gallery_popup
        max_number: 1

Extending and Overriding the Configuration

You can extend dimensions configuration with extra options or override the default configuration by implementing the Oro\Bundle\LayoutBundle\Provider\CustomImageFilterProviderInterface and tagging the service with the layout.image_filter.provider tag.

As an implementation example, see the Oro\Bundle\ProductBundle\Provider\WatermarkImageFilterProvider.

For the list of available options for the built-in filters and steps on how to create a custom filter, see the LiipImagineBundle filters reference.