ℹ️ This article is specific to the legacyAgillic Content Designer. Information provided may not apply to the New Agillic Content Designer. If your solution has been migrated to Agillic New Content Designer, please refer to this other article: How to Add a Verified Domain to Agillic.
With a verified domain, you can send emails using the selected domain and make your emails DMARC compliant. This ensures better deliverability, meaning more recipients will see your emails. Each of the links in your emails will also use the selected domain for tracking purposes. When you create a web page in Agillic with an anonymous Menu Item, recipients can access these pages by using any of your verified domains.
It's important to note that adding a verified domain in Agillic requires access to the subdomain(s) records. Therefore, it's advisable to get relevant IT personnel to help you with this process.
Setting up a verified domain in Agillic is a multi-step process. In this article, you'll find information about:
- Setting Up a Verified Domain
- Transactional Email Domains
- SMS Domain
- Warming up New Domains
Setting Up a Verified Domain
How to Select your Domain(s)
The first step is to select the domains you wish to set up. We highly recommend selecting a subdomain under any existing domain you may have. We also recommend using a new subdomain which isn't currently in use for anything. Part of setting up a verified domain in Agillic requires all web and email traffic to point to Agillic. For this reason, you shouldn't use any active subdomains as this will shut down any current email or website system you may have enabled. You should also avoid having subdomains that contain the word "agillic" and or "test".
For example, if your main domain is agillicandy.com, valid subdomains could be:
In special cases, it's possible to use a domain you also use for other purposes. For example, this could be the main domain or a domain used to send other communications not sent from Agillic. However, validating and using this type of domain isn't recommended as the reputation of the domain will be shared across multiple systems.
Agillic doesn't recommend selecting a campaign domain either, that is, using a standalone domain created with the sole purpose of being used for Agillic communications such as agillicnews.com.
From a reputation point of view, it detaches your general mail reputation from your campaign domain, meaning that all email service providers, such as Gmail, have to get to know your domain from scratch.
It also makes it easier for spammers and the likes to abuse your customers as it will be easy for spammers to buy similar domains such as agilliccommunications.com to spoof your customers with.
Please contact Agillic Support before setting up a domain that isn't a subdomain of your main domain. This type of configuration will require a different set up than the steps described below.
How to Set up your Domain(s)
- Log into Staging or Production.
- Open the Settings module.
- Under 'System Settings', open the 'Domains' subsection.
- Fill in your subdomain in both the 'From: domain name' field and the 'Link domain name' field.
- Click the plus icon next to the entry.
- Repeat steps 3 and 4 for each subdomain you want to set up.
You've now added your domains and should see a red 'Failed' label next to the entry. This indicates that the domain name is not yet verified.
If you want to track several subdomains on the same webpage/portal page, we highly recommended to use the same 'Line Domain Name'. You can read more about tracking on more than one subdomain on the same webpage/portal page here.
The Candy instance where two subdomains have been fully verified and one is still missing to have DNS records and certificate set
How to Verify your Domain(s)
Once the domain is set up, you'll need to make some DNS changes for the domain to point correctly to Agillic.
- Click the 'i' icon for your domain entry and a pop-up will appear.
- Note the DNS records, which has a red cross next to them. These are the DNS records you need to set up (CNAME, DKIM and TXT records.)
If there are no DNS records shown, you may already have DNS records for the selected domain. In this case, you should check if the subdomain is being used. If there's an old DNS record for the subdomain, you'll need to remove the old DNS records before you can see the records to be set from Agillic.
Please note that existing DNS records will prevent the CNAME record validation in Agillic. If you have configured the CNAME record correctly, but still see it failing validation in the Agillic UI, the additional DNS records needs to be removed in order for the CNAME record validation to succeed.
Once you have set up these DNS records in your own domain management system and are waiting for the caching period to pass, you should see a green checkmark next to these records. The verification label for the domain name will still show 'Failed' since the SSL certificate still needs to be set up.
A domain name where the domain still needs to have the three listed DNS records set
How to Apply the SSL Certificate
Agillic requires an SSL Certificate for the selected subdomain before the verification label will show 'Verified'. Contact Agillic Support and provide the certificate and private key for the subdomain. You must send both the certificate and private key in PEM format (X.509). Once delivered and the certificate is set up, Agillic Support will contact you and the domain will be verified.
Alternatively, it's also possible to use Agillic's 'Let's Encrypt' feature, where we can generate an SSL Certificate for you. This is a free service. If this is something you're interested in, simply contact Agillic Support.
Verify Current Emails
It's important to note that if you enable the 'Enable domain name validation' checkbox when you don't have any verified domains, all emails will fail during send-out.
Before you enable the 'Enable domain name validation' checkbox, make sure current emails use one of the valid domain names. For example, if Agillic Candy has set up 'marketing.agilliccandy.com' as a verified subdomain, all emails must send from a '@marketing.agilliccandy.com' address. If you set up an email to send from a '@agilliccandy.com' address, sending the email will fail once you check the 'domain name validation' checkbox.
Enable Domain Name Validation
Once you've corrected all current emails so they use one of your verified subdomains, you can enable the 'Enable domain name validation' checkbox.
How to Use a Verified Domain in an Email
- Create an email.
- Select the 'Properties' section in the right sidebar.
- Select one of your verified domains from the 'From Email address domain name' drop-down.
- Fill out the first part of the from email address in the 'From Email address' field. For example 'marketing'. The information from steps 3 and 4 will combine to make up the full from address.
For example, 'email@example.com'.
Selecting a verified domain name to use as the 'from email address domain name'
Transactional Email Domains
Transactional emails are, in short, any emails that result from a transaction. They are emails sent when a user or customer takes some action and contain information that's relevant to that action. This could be an order receipt, shipping confirmation, or password reset.
Please note that in order to use a domain for sending Transactional Emails, it must not have previously been used to send emails.
You can learn how to set up a domain for Transactional Emails here.
If you send an SMS from Agillic that contains a link, you might have experienced that the link changes to your Agillic solution name. If you want your own subdomain to be shown instead, you should create a subdomain specifically for the purpose of sending your SMSs, such as sms.agilliccandy.com. The subdomain should be a verified subdomain and registered in Agillic. So, we recommend that you follow the guide above on how to add a verified domain to Agillic.
When the subdomain is added and verified in Agillic, you need to contact the Product Specialists in Agillic Support to get it registered on your Agillic Solution. Please note that the SMS subdomain will only be registered on the Production environment and you will need to restart your Production environment to get the SMS subdomain fully implemented.
Warming up New Domains
In Agillic, you won't need to warm up your domain when switching, as we use pre-warmed IP addresses.
If you plan to send more than three million emails at once, please contact us for specific guidance.
When considering a complete email design update or switching to a new sender domain during your transition to Agillic, it's advisable to inform your customers in advance. This proactive step can prevent negative reactions, such as long-time customers who have been receiving emails from your brand for years and may be surprised by a sudden and significant change in the email appearance. By keeping your customers informed, you ensure a smoother transition and help maintain trust in your brand.