In order to use a custom notifications 'from' email or a custom domain, we require proof that you own the associated domains. In order to prove ownership of the domain(s) you need to add some records to your DNS. All records must remain on your DNS. We automatically re-verify every hour.
Custom 'From' Address (Notifications 'From' Email)
If you set up a custom 'from' address, but it is not verified, we will still send emails, but they will not come from your domain, they will come from email@example.com. If only one mail provider is configured, we will only send mail from that provider.
1. The following TXT record is required on the domain, with a format of:
This record allows us to ensure the domain belongs to you.
Setting multiple TXT records
All DNS providers allow for multiple records. You should check with your DNS provider for instructions on how to add multiple records. In general, multiple TXT records can be entered in a set of full quotation marks, on separate lines, like in the example below:
"Sample txt entries" "Enclose entries in quotation marks"
2. Your SPF record must include:
For help with SPF, go here.
Setting multiple SPF records
You can only have one SPF record per domain. However, you can set multiple SPF entries within that record.
Here's a valid example:
v=spf1 include:mailgun.org include:stspg-customer.com -all
Here's an invalid example:
v=spf1 include:mailgun.org -all v=spf1 include:stspg-customer.com -all
3. Setting up a DKIM record for provider #1 (Mailgun)
Setting this up will ensure we can send mail from your domain using this provider.
Note: If you're already using Mailgun to send emails from your domain for another service, we won't be able to add that domain a second time. In this case, we recommend using a subdomain for your custom 'from' address. For example, instead of firstname.lastname@example.org, email@example.com.
4. Setting up CNAME records (Sendgrid)
You will need to set three CNAME records to ensure we can send mail from your domain using this provider.
We require you to create a CNAME pointing to Statuspage with the following value:
status.company.com CNAME ABC123.stspg-customer.com
This will allow us to effectively route traffic to your status page through your custom domain.
For help with any of this, reach out to firstname.lastname@example.org.
Change DKIM keys to CNAME records
If you were previously using DKIM keys in your DNS configuration, you need to update them to the three CNAME records.
Click Your page > DNS configuration.
- You will only see the DNS configuration page listed under Your page if you have set a custom domain for your page and emails. Learn more here.
Click Invalidate this record now.
Add CNAME records to DNS configurations (AWS, DigitalOcean, BlueHost, etc)
Click Revalidate all records when the three CNAME records have been added.
What if I only configure one mail provider?
If only one mail provider is configured, we will send all mail for you through the configured provider. If a provider happens to go down, we make a system-wide change to throttle all mail to the functioning provider. If that provider is not configured properly on your page, all mail notification will be sent from email@example.com until we change the system-wide setting once both mail providers are up and running. For this reason, we recommend configuring both DKIM #1 and #2 to ensure your mail is always sent from your custom 'from' address.