Enable vanity URLs with /cf and /welcome prefixes in AEM as a Cloud Service

This article explains how to enable vanity URLs that begin with /cf and /welcome in Adobe Experience Manager as a Cloud Service by updating the configuration.

Description description

Environment

Adobe Experience Manager as a Cloud Service (all environments: development, staging, production)

Issue/symptoms

In Adobe Experience Manager as a Cloud Service, vanity URLs that start with /cf or /welcome may be blocked if these prefixes are included in the parameterOverride.classicUiPaths configuration. This behavior differs from AEM 6.5, where such vanity URLs are allowed by default.

  • Vanity URLs starting with /cf or /welcome are inaccessible in Adobe Experience Manager as a Cloud Service.

  • These URLs work as expected in AEM 6.5.

  • Example affected URLs:

    • https://example.com/cf1
    • https://example.com/welcome1

Cause

The presence of /cf and /welcome in the parameterOverride.classicUiPaths configuration blocks vanity URLs with these prefixes. Removing them allows the desired vanity paths to function.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Identify the environments where you need to enable vanity URLs with /cf and /welcome prefixes (such as development, staging, or production).
  2. Access the Adobe Experience Manager as a Cloud Service configuration for each affected environment.
  3. Locate the parameterOverride.classicUiPaths configuration parameter.
  4. Remove /cf and /welcome from the list of paths in parameterOverride.classicUiPaths.
  5. Save and deploy the updated configuration.
  6. Validate that vanity URLs starting with /cf and /welcome are accessible after deployment.

Note

If deployment pipelines are running, wait for them to complete before applying the configuration changes to avoid deployment conflicts.

What’s new and different in AEM as a Cloud Service

recommendation-more-help
experience-cloud-kcs-help-kbarticles