Deployment fails due to incorrect Core Components Data Layer configuration

Last update: Wed May 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

A Cloud Manager deployment for Adobe Experience Manager as a Cloud Service fails during the Install mutable content step when the Core Components Data Layer configuration under /conf is created with an incorrect node type. The configuration node is created as cq:Page, which doesn’t support the required enabled property, causing an OakConstraint0004 constraint violation and package installation failure.

To fix this, update the configuration node to use the correct primary type, set the required properties, and redeploy the corrected configuration package.

Description description

Environment

Adobe Experience Manager as a Cloud Service – Sites

Issue/Symptoms

The Cloud Manager pipeline fails during deployment with the error “Install mutable content – Failed.”
The mutable-content job fails while installing a cp2fm-converted configuration package, for example:
- /etc/packages/<group>/<site>-base-config-content-<version>-cp2fm-converted.zip
The pipeline logs show the following error:
- OakConstraint0004: /conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig[ [ cq:Page] ] : No matching property definition found for enabled = true.
The DataLayerConfig node is created as cq:Page, but cq:Page doesn’t define the enabled property, which causes the constraint violation and package installation failure.

Resolution resolution

Follow these steps to fix the issue:

Update the node at /conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig to use jcr:primaryType=nt:unstructured. Refer to Using the Adobe Client Data Layer with the Core Components for more details.
Set enabled=true as a Boolean property on the nt:unstructured node.
Ensure the configuration node isn’t created as cq:Page and doesn’t use a page template or page structure.
Verify that /content/<site>/jcr:content includes sling:configRef=/conf/<site> so the configuration is correctly referenced.
Rebuild the base configuration content package with these corrections.
Redeploy the package and confirm that the Install mutable content step and the overall deployment complete successfully.

Note:

Since Core Components version 2.9.0 and later, the Adobe Client Data Layer is included as part of the Core Components client libraries. To enable it, only the context-aware configuration under /conf/<site>/sling:configs is required. A separate Data Layer component installation package isn’t required.

recommendation-more-help