Custom Domains

By default your status page is reachable at {slug}.statuswerk.eu. On Pro and above you can use your own domain like status.your-company.com.

How it works

We provision a Let's Encrypt TLS certificate the moment your DNS points at our infrastructure — no manual cert upload, no renewals to worry about. Powered by Caddy On-Demand TLS.

Setup

  1. In Dashboard → Status pages → [your page] → Edit, open the Domain tab.

  2. Enter the hostname you want to use in Custom Domain (e.g. status.your-company.com) and save.

  3. Add both displayed records at your DNS provider — the CNAME that routes the traffic to us, and a TXT record that shows the domain is yours:

    status.your-company.com               CNAME   custom.statuswerk.eu
_statuswerk.status.your-company.com   TXT     statuswerk-verification=…

    The exact TXT value is shown in the status page settings (and by the API under verification_record); it is different for every domain.

  4. Wait for DNS propagation (usually under a minute, can take up to an hour).

  5. Click Verify DNS. We also check by ourselves every minute; you do not have to keep clicking. Once verified, we provision the certificate on first request — the first visitor may see a brief delay. Verify SSL shows whether the certificate is there yet.

A domain of its own such as yourcompany-status.com works too. It does not depend on your main domain, so the status page stays reachable when something goes wrong there: DNS, registrar or a hijacked domain. At the root of a domain (no status. in front) DNS allows no CNAME. Use the record your DNS provider offers for it, usually ALIAS, ANAME or "CNAME flattening", pointing at custom.statuswerk.eu. The TXT record is then _statuswerk.yourcompany-status.com.

The statuswerk.eu address stays reachable. With a custom domain your page still answers at {slug}.statuswerk.eu. Put that address in your incident plan: if your own DNS is affected, your customers still reach the status page through it.

Removing: in the same tab with Remove Domain. The page is then reachable on its statuswerk.eu subdomain only. This also works after moving to a plan without custom domains.

Through the API: PUT /api/v1/statuspages/{id}/custom-domain sets the domain, POST …/custom-domain/verify checks it, DELETE …/custom-domain removes it. See the API reference.

Notes

  • Each status page has one custom domain.
  • Without the TXT record the domain is not verified, even if the CNAME is right. That way nobody can take over a domain that still points at us but is not theirs. Domains already verified keep working unchanged; once verified, you can keep or delete the TXT record.
  • A domain that stays unverified for 30 days is released; you can add it again at any time.
  • HTTPS is enforced. HTTP requests are redirected to HTTPS automatically.
  • If you later remove the CNAME, your status page falls back to the statuswerk.eu subdomain — visitors at the custom domain receive a 404.