Hi Team,
How do you safely update the sling:configRef property of a page template structure in AEM as a Cloud Service, given that direct editing of /conf in Cloud Service is discouraged, and doing it incorrectly can break template-based content inheritance?
Hi @omarkh3,
In Cloud, updating the sling:configRef on a page template (especially when using editable templates) should NOT be done manually via CRXDE or page property dialogs in Cloud environments. Instead, the recommended way is:
This ensures all pages created from that template inherit the configuration cleanly.
Set it under:
/conf/<site>/settings/wcm/templates/<template>/structure/jcr:contentExample:
"sling:configRef" = "/conf/my-site/settings"Push this via code in the ui.content module, not via in-author changes.
If you also set it on the actual root page (e.g., /content/my-site), it can override the structure-level inheritance, causing issues with policies, styles, or context-aware configs.
Instead, let it flow from the template structure node.
/conf) ProperlyOrganize per site/language/country: /conf/site-ca, /conf/site-fr, etc.
Avoid reusing a single /conf/global across unrelated templates — this leads to maintainability and inheritance conflicts in AEMaaCS.
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.