ÃÛ¶¹ÊÓƵ

Documentation

URLs authored under /language-masters aren’t being correctly localized in corresponding live copy page

Last update: Thu Sep 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

This article provides a solution for an issue where URLs aren’t being localized in live copy pages during rollout due to nested live copies in ÃÛ¶¹ÊÓƵ Experience Manager (AEM).

Description description

Environment

  • ÃÛ¶¹ÊÓƵ Experience Manager as a Cloud Service (AEMaaCS)
  • ÃÛ¶¹ÊÓƵ Experience Manager 6.5.x (AEM 6.5.x), or higher

Issue/Symptoms

URLs authored in a component under /language-masters aren’t being correctly localized in the corresponding live copy pages. After performing a rollout, URLs in the live copy pages still point to the original /language-masters paths instead of the localized paths. This issue occurs specifically after the AEM upgrade or changes to MSM configuration.

Feature: Multi-Site Manager (MSM)
Configurations: CQ MSM References Update Action configuration

Resolution resolution

To resolve the issue, ensure that the update references across nested live copies setting is enabled in the CQ MSM References Update Action configuration. This setting allows references to be correctly updated within nested live copies during rollouts.

Steps to enable update references across nested live copies:

  1. Access configuration manager:

    • Go to the AEM Web Console Configuration Manager by navigating to http://<AEM-Instance>:<Port>/system/console/configMgr

  2. Locate CQ MSM references update action configuration:

    • Search for CQ MSM References Update Action in the configuration manager.

  3. Enable the setting:

    • Click on the configuration to edit it.
    • Find the setting labelled  Update References Across Nested Live Copies.
    • Check or enable this setting.

  4. Save and apply:

    • Save the configuration changes.
    • Ensure that the changes are applied by performing a rollout on a test page.

Example configuration path:

/apps/system/config/com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory.config

Verification:

  1. Create a test page in language master:

    • Author a component with a URL pointing to another page under/language-masters.

  2. Rollout the test page:

    • Perform a rollout to a live copy.
    • Verify that the URL in the live copy page is correctly transformed to point to the corresponding live copy page.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f