Using a custom email address

With Haiilo's Identity Package add-on, you can define a custom email address from which outgoing emails from your platform are sent. Additionally, you can define your own platform domain/URL.

Requirements

These are the requirements for setting up a custom email address:

  • Your platform is hosted in the Haiilo cloud.
  • You have to purchase the Identity Package add-on which includes the Custom Domain.
  • You own the domain you want to use and have access to the Domain Name System (DNS) server responsible for the domain.
  • The email domain needs to be a valid public domain, which requires having a reachable MX record, an A record, a designated SPF record, as well as DKIM and DMARC records.

A note on senders

All types of emails are sent from the one custom email address that you define, but the sender name, which appears as the 'From: Name' in users' inboxes, is different for system emails and Studio content:

  • For system emails, like those set up in Notification settings, the sender name is always what is input in the Network Name field in Administration > System settings > General settings
  • For the Studio's multichannel posts or email newsletters, the sender name will be based on the user, page, or community chosen as the publisher or sender in the Publish / Send as field when creating the content in the Studio. 

Set up a custom email

You need "Manage system settings" permission to set up a custom email address. 

  1. Go to Administration > System settings > Domain > Custom email.
  2. In the Custom email field, enter the email address you want your emails to be sent from.
    • If you're using a custom domain for your platform, you can't use the same domain for your custom email address. For example, if your platform is using the domain myintranet.example.com, you can't use noreply@myintranet.example.com for the email address. You can, however, use noreply@example.com as it's a different domain.
  3. Select Continue email setup.
  4. Copy the complete 4 TXT records into your DNS server managing your email domain: SPF, Domain verification, DMARC, and DKIM. All records need to be added.
  5. Once you've added the records in your DNS server, return to Haiilo and select Check DNS record.
  6. Your DNS will validate and a message will display depending on the result:
    • DNS Record Exist: When the DNS is validated, a green label reading "DNS Record Exist" appears, showing everything's set up correctly. You can move forward.
    • DNS Record Does Not Exist: If a red label reading "DNS Record Does Not Exist" appears, it means the DNS entry isn't correct yet or an old one is still cached. The cache duration is controlled by the "Time to Live" (TTL) setting in DNS. It might take up to the TTL for the DNS check to pass. If one or more TXT records aren't yet verified, the affected record is labeled as "Not verified". Check your setup and try again later.
  7. After the DNS is validated, select Activate this custom email to start using your custom email address.

Your custom email has been configured, and emails from your Haiilo platform will now be sent from the designated email address. 

After setting up a custom email address, changing the email or sender name isn't possible. You need to remove the custom address and set it up again to make changes.

Example: DNS verified
Example: DNS not yet verified

We implement DKIM and DMARC as extra email security measures. To learn more about email authentication technologies and why they are recommended, visit websites like https://dmarc.org/overview/.

Was this article helpful?

0 out of 0 found this helpful