How Adaptive Media Works

How Adaptive Media Works

Media providers must consider differences between devices (phones, laptops, tablets, etc.) when delivering content; not just their screen sizes but also their bandwidth and processing capabilities. Adaptive Media can control image quality and dynamically adjusts uploaded media to best fit the screen being used.

Adaptive Media integrates with Documents and Media, Blogs, Web Content, and Content Pages (starting with Liferay DXP 7.4+). It generates a set of images for use on various screens. When the content is accessed, Adaptive Media checks the screen type and resolution and selects the appropriate image. Adaptive Media comes pre-installed in DXP.


Adaptive Media is available OOTB for the following Commerce widgets: Search Results, Product Details, Product Publisher, Mini Cart widget and component, Checkout.

Here, you’ll learn about Adaptive Media and how to prepare it to handle images.

To use Adaptive Media, you must first define the resolutions for the images delivered to users’ devices. Adaptive Media then generates new images scaled to fit those resolutions, while maintaining the original aspect ratio. See Adding Image Resolutions to learn more about creating new Image Resolutions.

As noted above, you can use the adapted images in various types of content; see Using Adapted Images in Site Content.

To manage the Adaptive Media Image Resolutions, see Managing Image Resolutions.

If you have upgraded to the latest DXP version and were using a legacy version that did not support Adaptive Media, you can migrate existing Documents and Media thumbnails to new Adaptive Media defined Image Resolutions; see Migrating Documents and Media Thumbnails.

Additional Information