Configure web subdomains

Get started with web subdomains

When authoring web experiences, if you add content coming from the Adobe Experience Manager Assets library, you must set up the subdomain that will be used to publish this content.

You can use a subdomain that is already delegated to Adobe, or you can configure another subdomain. Learn more about delegating subdomains to Adobe in this section.

Web subdomain configuration is common to all environments. Therefore:

• To access and edit web subdomains, you must have the Manage Web Subdomains permission on the production sandbox.

• Any modification to a web subdomain will also impact the production sandboxes.

You can create several web subdomains, but only the default subdomain will be used. You can change the default web subdomain, but only one can be used at a time.

Access and manage web subdomains

To access subdomains for web experiences, follow these steps:

1. Browse to the Administration > Channels menu, then select Web settings > Web subdomains. All the subdomains set up with the current sandbox are displayed.

   

2. You can filter on the user who delegated each subdomain or one the delegation status (Draft, Processing, Success or Failed).

   

3. The Default badge is displayed next the subdomain that is currently used as default. To change the default subdomain, select Set as default from the More actions button next to the desired subdomain.

   

   You can change the default web subdomain, but only one can be used at a time.

Use an existing subdomain

To use a subdomain that is already delegated to Adobe, follow the steps below:

1. Access the Administration > Channels menu, then select Web settings > Web subdomains.

2. Click Set up subdomain.

3. Select the Use delegated subdomain option from the Configuration type section and choose a delegated subdomain from the list.

   

   NOTE

   You cannot select a subdomain that is already used as web subdomain.

4. The prefix that will display in your web URL is automatically added. You cannot change it.

5. To set this subdomain as default, select the corresponding option.

   

   Only the default subdomain will be used.

6. Click Submit. The subdomain gets the Success status. It is ready to be used for your web experiences.

   In very rare occasions, a subdomain setup could fail. In this case, you can delete the Failed subdomain to clean up the list using the Delete button from the More actions icon.

Configure a new subdomain

By default, Journey Optimizer allows you to delegate up to 10 subdomains in total (covering both email and web channels). However, depending on your license contract, you may be able to delegate up to 100 subdomains. Reach out to your Adobe contact to learn more about the number of subdomains you are entitled to.

To configure a new subdomain, follow the steps below:

1. Access the Administration > Channels menu, then select Web settings > Web subdomains.

2. Click Set up subdomain.

3. Select Add your own domain from the Configuration type section.

4. Specify the subdomain to delegate.

   CAUTION

   • You cannot use an existing web subdomain.

   • Capital letters are not allowed in subdomains.

   

   Delegating an invalid subdomain to Adobe is not allowed. Make sure you enter a valid subdomain which is owned by your organization, such as marketing.yourcompany.com.

   Multi-level subdomains (of the same parent domain) are supported. For example, you can use ‘web.marketing.yourcompany.com’.

5. To set this subdomain as default, select the corresponding option.

   NOTE

   Only the default subdomain will be used.

6. The record to be placed in your DNS servers displays. Copy this record, or download a CSV file, then navigate to your domain-hosting solution to generate the matching DNS record.

7. Make sure that DNS record has been generated into your domain-hosting solution. If everything is configured properly, check the box “I confirm…”, then click Submit.

   

   When you configure a new web subdomain, it always points to a CNAME record.

8. Once the subdomain delegation has been submitted, the subdomain displays in the list with the Processing status. For more on subdomains’ statuses, refer to this section.

   Before being able to use that subdomain to send web messages, you must wait until Adobe performs the required checks, which can take up to 4 hours.

9. Once the checks are successful, the subdomain gets the Success status. It is ready to be used to create web channel configurations.

   Note that the subdomain will be marked as Failed if you fail to create the validation record on your hosting solution.

Undelegate a subdomain

If you wish to undelegate a web subdomain, contact your Adobe representative.

However, you need to perform several steps in the user interface before reaching out to Adobe.

First, perform the following steps in Journey Optimizer:

1. Deactivate all the channel configurations associated with the subdomain. Learn how

2. Stop the active campaigns associated with the subdomains. Learn how

3. Stop the active journeys associated with the subdomains. Learn how

4. If the web subdomain was a new delegated subdomain, remove the DNS entries associated with that subdomain.

Once done, reach out to your Adobe representative with the subdomain you want to undelegate.

After you request is handled by Adobe, the undelegated domain is no longer displayed on the subdomain inventory page.