Browse the docs

Custom domains

Serve your page at status.yourdomain.com: the TXT record, the CNAME, and verification.

On this page
  1. Add the domain
  2. HTTPS
  3. Several domains
  4. Removing a domain
  5. Common problems
  6. API

A custom domain puts the page at a hostname you own, typically status.yourdomain.com. It needs two DNS records and a click. Available on Starter and Team.

Add the domain

  1. Open the page and find Custom domains

    Type the hostname and choose Add domain. Only the hostname, no scheme and no path: status.acme.com.

  2. Create the two records at your DNS provider
    TypeNameValue
    TXT_statusbee.status.acme.comthe token shown in the dashboard, statusbee-verify=…
    CNAMEstatus.acme.comyour page's default address, acme-cloud.statusbee.co

    The TXT record proves you control the name. The CNAME sends visitors to us.

  3. Verify

    Choose Verify next to the domain. We look up the TXT record and mark the domain verified when it matches. DNS can take a few minutes to propagate; if verification fails, wait and try again. There is no limit on attempts.

HTTPS

A certificate is issued for the hostname once it is verified and the CNAME resolves to us. Until issuance completes the domain shows as pending. The page keeps answering at its statusbee.co address the whole time, so nothing is offline while you wait.

Several domains

A page can have more than one custom domain, for example status.acme.com and status.acme.io. Each is verified separately. There is no charge per domain.

Removing a domain

Delete it from the page's Custom domains list, then remove the DNS records. Visitors to the old hostname will get a DNS error once the CNAME is gone; the statusbee.co address continues to work.

Common problems

SymptomUsual cause
Verification keeps failingThe TXT record is on the wrong name. It must be _statusbee. followed by the full hostname, not the bare domain.
Verified, but the hostname shows an error pageThe CNAME is missing, or points at the wrong target. It should point at the page's default address, not at statusbee.co.
Provider will not let you add a CNAMESome providers block CNAMEs at the apex (acme.com). Use a subdomain such as status.acme.com.
Add domain is disabledCustom domains start on Starter. Upgrade under Billing.

API

POST /user/pages/:id/domains returns the records to create; POST /user/pages/:id/domains/:domainId/verify runs the check. See Status pages in the API reference.