About URL Handler

URL resolving and processing.

Maven Central



The URL Handler provides:

  • Building URLs from path, selectors, extension, suffix query string an fragment parts
  • Externalizing links for page links and frontend resources
  • Supporting different URL Modes for externalizing to HTTP/HTTPs, with full hostname or protocol-relative mode
  • Hostnames used for externalization for HTTP and HTTPs are stored in Context-Aware Configuration
  • Rewrites URLs to current site
  • Suffix Builder and Parser for passing around information via Sling Suffix string
  • Supports externalizing URLs for Integrator Template Mode with placeholders or Full URLs
  • Supports externalizing URLs in generated markup via Sling Rewriter
  • Rewrites resource URLs pointing to client libraries with “allowProxy” mode to /etc.clientlibs.
  • Generic Sling Models for usage in views: Sling Models
  • Generic Granite UI components that can be used in link dialogs

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

AEM Version Support Matrix

URL Handler version AEM version supported
2.0.x or higher AEM 6.5.17+, AEMaaCS
1.7.2 or higher AEM 6.5.7+, AEMaaCS
1.7.0 AEM 6.5+, AEMaaCS
1.5.x - 1.6.x AEM 6.4.5+, AEMaaCS
1.4.x AEM 6.3.3+, AEM 6.4.5+
1.2.x - 1.3.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

GitHub Repository

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

Back to top

Version: 2.0.1-SNAPSHOT. Last Published: 2024-01-26.