Information for: DEVELOPERS   PARTNERS

Important

There are references to mautic.net and maestro.mautic.com due to the products’ previous names. Note that these links are valid.

Custom domains

Campaign Studio and Campaign Factory subscribers use the Campaign Factory user interface to configure custom domains. This applies to any subscribers using Campaign Studio’s email delivery service, Sparkpost. Subscribers using their own email delivery provider (including their own Sparkpost credentials) aren’t required to add a custom domain.

Understanding custom domains

Getting your message out to the world is one of the reasons you chose to use Campaign Studio. Creating a custom domain for the landing pages ensures your message is seen and is on-brand.

When a contact views a landing page you’ve created in Campaign Studio, you want the brand experience to be as seamless as possible. A custom domain for your Campaign Studio instance directs users to your domain, not Campaign Studio’s.

When users create instances, they’re created as yourcompany.mautic.net. Landing pages from the instance have a URL like https://yourcompany.mautic.net/landing-page-name. A custom domain would make the URL something like https://sample.yourdomain.com/landing-page-name.

Creating a custom domain

Important

While possible to create a custom subdomain after you’ve started using Campaign Studio, Acquia highly recommends creating one at instance creation. If you don’t, it can cause issues with images, links, forms, and your tracking code.

To add your custom domain:

  1. Once you’ve determined your custom domain, add a record to your DNS manager, sign in to your domain name’s host, and create the following record:

    Type: CNAME
    Name: [subdomain]
    Points to: mautic.net, eu.mautic.net, or apj.mautic.net
    (depending on which region your instance is hosted in)
    

    If you aren’t sure which region is correct, your Digital Experience Consultant can help you.

    The DNS change can take a few hours for the record to propagate, depending on the TTL setting.

    Note

    Prior to updating the domain in Campaign Factory, Acquia recommends that you add the DNS record to point the domain to the custom domain. Once you add the domain, navigate to the new custom domain. Although not mandatory, you can wait till you see a “Lost by chance?” page.

    Doing the opposite might cause validation delays. If you have added the record and can’t access your instance from the custom domain, open a support ticket.

  2. Log in to Campaign Factory at maestro.mautic.com.

  3. Click Instances.

  4. Next to the instance you want to change, click the pencil icon to edit the instance. If you haven’t created the instance yet, you can create one during the instance creation process. See Accounts and instances.

    Maestro Edit Instance

    Create Instance

  5. Toggle the switch for I have my own domain.

  6. Enter your custom domain. You must include the Subdomain and your website’s domain (for example: example.acquia.com). Campaign Studio saves a subdomain with mautic.net, which is necessary for its database.

  7. After adding the DNS record, sign in to your Campaign Studio instance using the custom domain.

Validating custom domains

Campaign Factory allows you to validate the custom domains. Thus, you can get the domains validated instantly without depending on automated jobs that get triggered after a fixed duration.

To validate custom domains:

  1. Sign in to your Campaign Factory account.

  2. Go to Instances and select a custom instance.

  3. Click (Re)Validate Custom Domain.

    validate_5

    The system sends the validation request.