Docs

Custom domains

Serve your help center and status page on your own hostname.

Your help center and status page can be served on your own hostname, such as help.yourcompany.com or status.yourcompany.com. You prove you own the domain with a DNS record; the certificate is issued automatically once it routes here.

What the tenant does

Settings of the help center or status page → Custom domain:

  1. Enter the hostname (a subdomain such as help.yourcompany.com is easiest) → Add domain.
  2. Create the two records shown:
    • Routing: CNAME help.yourcompany.com → <CNAME target>. On a root domain (yourcompany.com) a CNAME is not allowed: use the DNS provider’s ALIAS / ANAME / “CNAME flattening” to the target, or A/AAAA records to the apex IPs shown.
    • Ownership: TXT _istyping-challenge.help.yourcompany.com → pv1-…. Keep it in place afterwards: it is what stops anyone else on the service from ever claiming the domain. Already have a _parley-challenge.… record from before? It still counts; you don’t need to change it.
  3. Check now (or wait: pending domains are re-checked automatically with backoff for ~2 weeks). Each record shows its own result (“TXT record not found yet — DNS changes can take up to an hour”, “CNAME points to X, expected Y”, “Domain is proxied by a CDN; set the record to DNS-only”, …).
  4. The stepper goes Add records → Verifying DNS → Issuing certificate → Live.

Cloudflare note: a record with the orange cloud (proxied) hides where the name points and breaks the HTTP-01 certificate validation. Tenants must set the record to DNS-only (grey cloud).