Usage and admin help
Configure your DNS
Before you begin
In order to have your page hosted on a custom domain or have notifications sent from a custom 'from' email address, you need to add DNS records establishing that you own the associated domain(s). All records must remain on your DNS. We automatically re-verify every hour.
Configuring DNS for a custom domain
Once you've specified a custom domain, you'll need to establish ownership of the domain by creating a new CNAME record in your DNS. This allows us to route traffic to your status page through your custom domain.
Until you complete this configuration, your status page remains visible at its statuspage.io subdomain (e.g. mycompany.statuspage.io).
Navigate to Your Page > DNS configuration.
In the Custom domain table, copy the Expected value for your custom domain.
In your own DNS configuration, add a CNAME record pointing to this expected value.
Wait for us to validate your DNS record. When this is complete, you'll see a green checkmark next to your custom domain on the DNS configuration page.
The expected value for your CNAME record will look like this:
What if I'm using a CDN for my custom domain?
Custom domains using CDNs require additional setup. Please contact us if you're attempting to use this approach.
Configuring DNS for a custom 'from' email address
After you specify a custom 'from' address for email notifications, you need to set DNS records to establish your ownership of the email domain. To see the required DNS entries, navigate to Your page > DNS configuration and consult the Navigation 'from' email section.
Until you complete this configuration, notifications for your page will continue to be sent from the default address, firstname.lastname@example.org.
1. Create a TXT record on your domain, with a format of:
This record allows us to ensure the domain belongs to you.
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:
2. Create an SPF record that includes:
For help with SPF, see Email Deliverability.
You can only have one SPF record per domain. However, you can set multiple SPF entries within that record.
Here's a valid example:
Here's an invalid example:
3. Create 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 email@example.com, firstname.lastname@example.org.
4. Create CNAME records for provider #2 (Sendgrid)
You will need to set three CNAME records to ensure we can send mail from your domain using this provider.
What if I only configure one mail provider?
If you only configure one mail provider, 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.
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.
Navigate to 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.
Was this helpful?