Set a custom domain and SSL

Your status page automatically comes with a statuspage.io subdomain (for example mycompany.statuspage.io). Before launching your page to end users, you can set up a custom domain (e.g. status.mycompany.com) as the URL for your page. If possible, we recommend that you make this a dedicated domain (e.g. www.mycompanystatus.com). Otherwise, if your DNS provider is down, your status page will be down too.

Until you complete the DNS configuration step, the default URL for your status page will be your statuspage.io subdomain.

There are some limitations on using custom domains, depending on the visibility of your status page.

  • Public pages can use a custom domain, except for pages on the Free plan.

  • Audience-specific pages can use a custom domain, except for pages with single sign-on enabled.

  • Private pages cannot use a custom domain.

  • Trial pages cannot use a custom domain. While custom domain and SSL are included in trial plans, your custom domain will redirect to your trial page URL until your page is activated. Therefore, SSL won’t work until you activate your page and your custom domain is verified.

If you want to publish custom HTML or CSS changes to your page, you'll need to set a custom domain.

Set a custom domain

To set up a custom domain:

  1. Navigate to Your page > Customize page and emails

  2. See the Custom domain field listed under the Customize status page tab.

  3. Enter your custom domain.

  4. Click Save page customizations.

Set custom domain

 

After you specify the custom domain you want to use, we'll provide you with instructions on how to set a DNS record pointing to your page. Once you've done this, you can enable SSL for your page.

Configuring DNS

Once you've set the custom domain, we'll provide you with instructions to configure your DNS to make your custom domain work. Once we've validated your DNS configuration, visitors to your custom domain will see your status page.

  1. Go to Your Page > DNS configuration.

  2. Copy the Expected value for your custom domain in the Custom domain table.

  3. Add a CNAME record pointing to this expected value in your own DNS configuration.

    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.

Note: If you have configured a custom domain on a trial page, visitors to your custom domain will be redirected to your statuspage.io subdomain until you activate the page.

Enabling SSL

There's no need to provide your own SSL certificate. We dedicate a slot for you under our shared SAN certificate. You must have already set a custom domain and configured DNS in order to enable SSL.

To enable SSL:

  1. Go to Your page > Customize page and emails.

  2. Select the Customize status page tab.

  3. Click Enable SSL.

If you need to disable SSL for some reason, contact us.

Additional Help