Custom domains¶

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 such as 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¶

To add your custom domain:

1. After determining 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 (insert your instance's subdomain):
   <subdomain>.mautic.net; if the instance is hosted in US cloud
   <subdomain>.eu.mautic.net; if the instance is hosted in EU cloud
   <subdomain>.apj.mautic.net; if the instance is hosted in APJ cloud
   

   If you are unsure about the region for your instance, you can find this information in the Location field when editing the instance. If the location is:

   • Mautic US or ACS US, use .mautic.net.
   • Mautic EU or ACS EU, use .eu.mautic.net.
   • Mautic APJ or ACS APJ, use apj.mautic.net.

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

   Note

   Before updating the domain in Campaign Factory, ensure that you add the DNS record to point the domain to the custom domain. After adding the domain, navigate to the new custom domain. Although not mandatory, you can wait until you see a “Lost by chance?” page.

   Doing the opposite might cause validation delays. If you have added the record and cannot 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. Locate the instance that you want to edit.

   If you have not created the instance, you can create one during the instance creation process. For more information, see Accounts and instances.

5. Click the pencil icon next to the instance.

   

   

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

7. Enter your custom domain.

   You must include the Subdomain and your website’s domain, such as example.acquia.com. Campaign Studio saves a subdomain with mautic.net, which is necessary for its database.

   • Your domain can only contain letters, numbers, or a dash. It cannot start or end with a dash or have two dashes in a row.
   • Your subdomain must contain at least 3 characters.
   • Custom domains may contain mixed-case letters.

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

   

   The system sends the validation request.