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.