Configure custom channel subdomains custom-channel-subdomains

On this page: Learn how to set up custom channel subdomains in Adobe Journey Optimizer to enable link tracking in your messages, either by using an existing delegated subdomain or configuring a new one with a DNS record.

Get started with custom channel subdomains gs-custom-channel-subdomains

To enable link tracking in your custom channel messages, you must set up the subdomain you will select when creating a custom channel configuration.

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

Custom channel subdomain configuration is shared between all environments. Therefore, any modification to a custom channel subdomain also impacts other production sandboxes.

Use an existing subdomain custom-channel-use-existing-subdomain

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

  1. Browse to the Administration > Channels menu, and select Channel Builder > Subdomains.

    Custom channel subdomains inventory {width="100%"}

  2. Click Create custom channel subdomain.

  3. Select Use delegated subdomain from the Configuration type section.

    Use delegated subdomain configuration form {width="90%"}

  4. Enter the prefix that will display in your custom channel URL. Only alpha-numeric characters and hyphens are allowed.

    The prefix is used to create a unique subdomain for this custom channel. For example, if you enter promo and select the subdomain luma.com, the resulting subdomain will be promo.luma.com.

    note caution
    CAUTION
    Do not use cdn or data prefixes as these are reserved for internal use. Other restricted or reserved prefixes such as dmarc or spf should also be avoided.
  5. Select a delegated subdomain from the list.

    You cannot select a subdomain that is already used as a custom channel subdomain.

    note caution
    CAUTION
    If you select a domain that was delegated to Adobe using the CNAME method, you must create the DNS record on your hosting platform. To generate the DNS record, the process is the same as when you configure a new custom channel subdomain. Learn how in this section.
  6. Click Submit.

  7. Once 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 messages, you must wait until Adobe performs the required checks, which can take up to 4 hours.

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

Configure a new subdomain custom-channel-configure-new-subdomain

To configure a new subdomain, follow the steps below.

  1. Browse to the Administration > Channels menu, then select Channel Builder > Subdomains.

  2. Click Create custom channel subdomain.

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

    Add your own domain configuration form {width="70%"}

  4. Specify the subdomain to delegate.

    note caution
    CAUTION
    • You cannot use an existing custom channel 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 ‘custom.marketing.yourcompany.com’.

  5. 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.

  6. 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.

    DNS record confirmation checkbox before subdomain submission

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

  7. 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 using a subdomain to send custom channel messages, you must wait until Adobe performs the required checks, which can take up to 4 hours. Once the checks are successful, the subdomain gets the Success status. It is ready to be used to create custom channel configurations.

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

Next steps next-steps

  • Create a channel configuration to link your custom channel to a subdomain, credentials, and payload defaults that marketers will select in campaigns and journeys.
AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to configure a custom channel subdomain in Journey Optimizer to enable link tracking in custom channel messages, either by using a subdomain already delegated to Adobe or by configuring a new subdomain with a DNS record.

Intents:

  • Set up a custom channel subdomain to enable link tracking in custom channel messages
  • Use a subdomain that is already delegated to Adobe as a custom channel subdomain
  • Configure a new subdomain by generating the matching DNS record on your domain-hosting solution
  • Understand subdomain statuses during processing and validation
  • Prepare a subdomain to select when creating a custom channel configuration

Glossary:

  • Custom channel subdomain: The subdomain you set up and then select when creating a custom channel configuration, used to enable link tracking in custom channel messages (product-specific)
  • Prefix: The value that displays in your custom channel URL and is combined with a delegated subdomain to create a unique subdomain; only alpha-numeric characters and hyphens are allowed (product-specific)
  • Use delegated subdomain: The Configuration type option for using a subdomain already delegated to Adobe (product-specific)
  • Add your own domain: The Configuration type option for configuring a new subdomain to delegate (product-specific)
  • CNAME method: A subdomain delegation method; a subdomain delegated with this method requires you to create the DNS record on your hosting platform (product-specific)

Guardrails:

  • Custom channel subdomain configuration is shared between all environments, so any modification to a custom channel subdomain also impacts other production sandboxes.
  • Do not use cdn or data prefixes as these are reserved for internal use; other restricted or reserved prefixes such as dmarc or spf should also be avoided.
  • You cannot select a subdomain that is already used as a custom channel subdomain, and you cannot use an existing custom channel subdomain when adding your own domain.
  • Capital letters are not allowed in subdomains, and delegating an invalid subdomain to Adobe is not allowed; the subdomain must be valid and owned by your organization.
  • Multi-level subdomains of the same parent domain are supported (for example, custom.marketing.yourcompany.com).
  • After submission, Adobe performs the required checks, which can take up to 4 hours before the subdomain can be used to send messages.
  • If you select a domain that was delegated to Adobe using the CNAME method, you must create the DNS record on your hosting platform.
  • When you configure a new custom channel subdomain, it always points to a CNAME record.

Terminology:

  • Canonical name: Custom channel subdomain — Acronym: n/a — variants: custom channel subdomain configuration
  • Do not confuse: “Use delegated subdomain” (Configuration type for a subdomain already delegated to Adobe) ≠ “Add your own domain” (Configuration type for configuring a new subdomain)
  • Do not confuse: “Processing” (status shown after submission while checks run) ≠ “Success” (status once checks are successful and the subdomain is ready to use) ≠ “Failed” (status if you fail to create the validation record on your hosting solution)

FAQ:

  • Q: Why do I need a custom channel subdomain? — You must set up a subdomain to enable link tracking in your custom channel messages, and you select it when creating a custom channel configuration.
  • Q: What are the two ways to set up a custom channel subdomain? — You can use a subdomain that is already delegated to Adobe (Use delegated subdomain), or configure a new subdomain by adding your own domain and generating the matching DNS record.
  • Q: How long does subdomain validation take? — After submission the subdomain shows the Processing status, and Adobe performs the required checks, which can take up to 4 hours before you can use it to send messages.
  • Q: Which prefixes are not allowed? — Do not use cdn or data prefixes because they are reserved for internal use, and avoid other restricted or reserved prefixes such as dmarc or spf.
  • Q: Does a change to a custom channel subdomain affect other sandboxes? — Yes, custom channel subdomain configuration is shared between all environments, so any modification also impacts other production sandboxes.
  • Q: What happens if the DNS validation record is not created? — The subdomain is marked as Failed if you fail to create the validation record on your hosting solution.
recommendation-more-help
journey-optimizer-help