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).

  1. Navigate to Your Page > DNS configuration.

  2. In the Custom domain table, copy the Expected value for your custom domain.

  3. In your own DNS configuration, add a CNAME record pointing to this expected value.

    1. If your domain is behind a CDN or another service that prevents us from retrieving the value of the CNAME record you can verify domain ownership by using a TXT record instead.

    2. To verify ownership using a TXT record click the Add TXT record button in the Custom Domain section of the DNS configuration page. This will add a new row to the custom domain section

    3. Add a new TXT record to your domain with the expected value and click Revalidate all records at the top of the page

    4. Your domain will still need the CNAME record set in order for us to route requests correctly

  4. 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:

1 <PAGE_CODE>.stspg-customer.com

For example:

1 status.company.com CNAME ABC123.stspg-customer.com

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, noreply@statuspage.io.

1. Create a TXT record on your domain, with a format of:

1 status-page-domain-verification=<ORGANIZATION_CODE>

This record allows us to ensure the domain belongs to you. If your domain is a subdomain the record can be placed on the subdomain itself or the apex domain. Both will be checked to complete verification for domain ownership.

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:

1 2 "Sample txt entries" "Enclose entries in quotation marks"

2. Create an SPF record that includes:

1 stspg-customer.com

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:

1 v=spf1 include:mailgun.org include:stspg-customer.com -all

Here's an invalid example:

1 2 v=spf1 include:mailgun.org -all v=spf1 include:stspg-customer.com -all

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 status@company.com, status@notifications.company.com.

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 noreply@statuspage.io 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.

  1. 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.

  2. Click Invalidate this record now.

  3. Add CNAME records to DNS configurations (AWS, DigitalOcean, BlueHost, etc)

  4. Click Revalidate all records when the three CNAME records have been added.

Additional Help