Email domain whitelabeling allows you to send emails from your own custom domain, enhancing brand consistency and improving email deliverability.
This guide walks you through the process of setting up email domain whitelabeling by inputting your domain and configuring three essential DNS records.
Prerequisites
Access to your domain’s DNS management panel (e.g., through your domain registrar or hosting provider like GoDaddy, Namecheap, Cloudflare, etc.).
A custom domain (e.g., yourdomain.com).
An email service provider that supports whitelabeling (check with your provider for specific instructions).
Create your email domain in Orbiit
Navigate to your Workspace settings whitelabeling section. You can get here by clicking the avatar top right and navigating to "Whitelabeling". When you have access to the domain whitelabeling feature you will see the "Add Domain" button.
Enter the domain in the Orbiit UI. Do not include subdomains like www.yourdomain.com.
Please note: at the moment we will be sending emails from [email protected]. In a future release you will be able to add and change your own send-from domain.
Configure the DNS records
Once the domain is added you will see a screen appear with 3 DNS records that need to be configured. These are record you will need to add on your side at your DNS provider and they will essentially tell the world that we are allowed to send emails on behalf of you and from your domain.
The three records that need to be configured will be shown yellow when they are not configured yet in your DNS and once we can see them as configured they will turn green. Each of the records shown will show a record type (all CNAME), a host and a value.
The "Verify" button in the top-right allows you to check if we can find the records. Please note that it may take 24-48 hours for a DNS record to 'propagate', which means that it can take some time before we see them as valid.
Configure SPF
To ensure we can send emails on your behalf we also need you to have your SPF and DMARC configured correctly.
SPF: Most likely you already have an SPF record in place. This is a
TXTrecord that looks like:"v=spf1 include:<somedomain.com> ~all". What we want you to do is update this record to includeinclude:_spf.orbiit.app. This means the total record will become: `"v=spf1 include:<somedomain.com> include:_spf.orbiit.app ~all".DMARC: In addition the DMARC record also adds some additional security. Make sure you have this in place. You can use this DMARC check to see if you have it configured properly.
Wait for DNS propagation.
DNS changes can take anywhere from a few minutes to 48 hours to propagate globally. Most providers offer a verification tool to check if the records are correctly configured.