Documentation

Adding additional language to “cq:tags” not working in AEMaaCS

Last update: Wed Jun 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In Adobe Experience Manager as a Cloud Service (AEMaaCS), attempts to add Dutch (nl) as a supported language under cq:tags succeed locally but fail to reflect in the development environment after deployment via Cloud Manager. To resolve the issue, update filter configuration and verify language support.

Description description

Environment

Adobe Experience Manager (AEM) as a Cloud Service – Sites

Issue/Symptoms

  • Dutch (nl) language added under cq:tags locally does not appear in the development environment.

  • The following steps are taken to mitigate the issue, but the updated configuration did not reflect in the development environment:

    • Added a .content.xml file under ui.content/src/main/content/jcr_root/content/_cq_tags
    • Updated the filter.xml file under ui.content/src/main/content/META-INF/vault/filter.xml with <filter root="/content/cq:tags" mode="merge"/>

  • Deployment completes without errors, but changes are not reflected.

Resolution resolution

To resolve this issue, follow these steps:

  1. Ensure that Dutch (nl) is included under recognized languages in AEM by verifying its presence at /libs/wcm/core/resources/languages/nl, and if absent, create it by copying an existing language node and updating its properties accordingly.

  2. Update the languages property in cq:tags:

    1. Navigate to /content/cq:tags.
    2. Edit the languages property (multi-string).
    3. Add nl to the list: [ en, de, es, fr, it, nl].
    4. Save the changes.

  3. Update your filter.xml configuration by replacing <filter root="/content/cq:tags" mode="merge"/> with <filter root="/content/cq:tags" mode="update"/> to ensure that existing content is updated along with the addition of new configurations, as the “merge” mode only adds new content without modifying existing settings.

  4. Redeploy your code using Cloud Manager after making the adjustments, and verify that Dutch (nl) appears as a supported language under /content/cq:tags.

Tag language settings disappear after service pack installation in AEM documentation

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f