Skip to main content

Custom Domains for Status Pages

Replace the default status.pingsla.com/your-slug URL with your own branded domain such as status.yourapp.com.

Requirements

  • A domain you control with access to its DNS settings
  • Status page is Public
  • Growth plan or higher

Setup

Step 1 — Add the Custom Domain in PingSLA

  1. Open your status page in the dashboard
  2. Go to Settings → Custom Domain
  3. Enter your domain: status.yourapp.com
  4. Click Save

PingSLA will display a CNAME target for you to configure.

Step 2 — Configure DNS

Add a CNAME record at your DNS provider:

TypeNameValueTTL
CNAMEstatuscname.pingsla.com300

If your apex domain (yourapp.com) needs to be a status page, use an ALIAS or ANAME record instead of CNAME (supported by Cloudflare, Route 53, etc.):

TypeNameValue
ALIAS@cname.pingsla.com

Step 3 — Verify Propagation

DNS propagation typically takes 1–30 minutes. Verify with:

dig CNAME status.yourapp.com
# Should return: cname.pingsla.com

Step 4 — SSL Certificate

PingSLA automatically provisions a Let's Encrypt SSL certificate for your custom domain after DNS propagation is confirmed. This takes up to 5 minutes after the CNAME resolves correctly.

You will see a Verified badge on your custom domain setting once SSL is active.

Cloudflare Proxy

If your domain is behind Cloudflare:

  1. Set the proxy mode to DNS Only (grey cloud icon) for the CNAME record
  2. Cloudflare proxy (orange cloud) can cause SSL handshake conflicts with PingSLA's certificate provisioning

Once verified, you may re-enable Cloudflare proxy if desired. PingSLA's origin certificate is compatible with Cloudflare proxy mode.

Troubleshooting

IssueResolution
Domain shows PingSLA 404DNS not propagated yet — wait and retry
SSL not provisioningVerify CNAME resolves to cname.pingsla.com before SSL is issued
Mixed content warningsEnsure all embedded resources use HTTPS
Cloudflare SSL errorTemporarily disable Cloudflare proxy during initial verification
Domain stuck as "Pending"Check that CNAME is at the correct subdomain level

Removing a Custom Domain

  1. Go to Status Page Settings → Custom Domain
  2. Click Remove Domain
  3. Delete the CNAME record from your DNS provider

The status page will revert to the default status.pingsla.com/your-slug URL.