wcm.io Configuration (deprecated)

Context-specific configuration for AEM applications.

PLEASE NOTE: wcm.io Configuration is deprecated (although still fully maintained). For new projects please use the Apache Sling Context-Aware Configuration, with support from wcm.io Context-Aware Configuration. There is a wiki page how to migrate: Migrate from wcm.io Configuration 0.x to Context-Aware Configuration.

Context-specific configuration

wcm.io Configuration manages context-specific configuration, that means configuration that cannot be stored as OSGi configurations. OSGi configurations are always system-wide, so they are not well-suited for storing configurations per context e.g. site, region or tenant. Each context can be described as a path in the resource hierarchy including its subtree. Contexts can be nested.

This wcm.io subproject implements APIs and SPIs to provide a flexible configuration infrastructure for reading and managing context-specific configuration. The implementation is pluggable which ensures it can be adapted to the application needs. It’s based on OSGi services.

The problems and usecases solved by this implementation are described in the wcm.io Wiki Multi Tenancy and Configuration Requirements page (although not everything described there is implemented currently). For detailed documentation and usage descriptions see below.


  • API: API and SPI for context-specific configuration.
  • Implementation: Context-specific configuration management implementation.
  • Configuration Editor: Configuration Editor Template for AEM.
  • Sample Application: Sample application to demonstrate configuration API and configuration editor GUI.

GitHub Repository

Sources: https://github.com/wcm-io/wcm-io-config

Back to top

Version: 0.5.9-SNAPSHOT. Last Published: 2019-03-01.