About Media Handler

Media resolving, processing and markup generation.

Maven Central



The Media Handler provides:

  • Build URLs for media assets like images and downloads (based on URL Handler)
  • Pluggable media sources (with default implementations for DAM and binaries stored inside a content page)
  • Pluggable markup builders for different media types (e.g. images, DAM video)
  • Media format concept that allows to define expected output formats (with constraints for dimension, ratio, file type and others)
  • Rendering virtual renditions to match the expected output format
  • Supports manual and automatic cropping and rotation of images and image maps
  • Support for responsive images by rendering multiple renditions at once for each breakpoint
  • Define media handling via Java API, content policies or component properties
  • Pluggable media pre- and postprocessing to further tailoring the media handling process
  • Generic Sling Models for usage in views: Sling Models
  • Generic HTL Placeholder template
  • Generic Granite UI components that can be used in media/image component dialogs
  • Support for Dynamic Media
  • Support for Next Generation Dynamic Media on AEMaaCS
  • Support for Web-Optimized Image Delivery: On AEMaaCS instances renditions are transparently rendered on the edge

Read the general concepts to get an overview of the functionality.

AEM Version Support Matrix

Media Handler version AEM version supported
2.0.x or higher AEM 6.5.17+, AEMaaCS
1.14.4 or higher AEM 6.5.7+, AEMaaCS
1.14.0 - 1.14.2 AEM 6.5+, AEMaaCS
1.10.x - 1.13.x AEM 6.4.5+, AEMaaCS
1.8.x - 1.9.x AEM 6.3.3+, AEM 6.4.5+
1.2.x - 1.7.x AEM 6.2+
1.0.x - 1.1.x AEM 6.1+
0.x AEM 6.0+


To use this module you have to deploy also:

wcm.io Sling Commons Maven Central
wcm.io AEM Sling Models Extensions Maven Central
wcm.io WCM Commons Maven Central
wcm.io WCM Granite UI Extensions Maven Central
wcm.io Handler Commons Maven Central
wcm.io URL Handler Maven Central

GitHub Repository

Sources: https://github.com/wcm-io/io.wcm.handler.media

Back to top

Version: 2.0.9-SNAPSHOT. Last Published: 2024-05-23.