Set a custom domain for a status page
Connect a hostname you control and follow its DNS and certificate state in HowlOps.
Custom domains require a Status pages capability that includes this feature. See the pricing page for current availability.
Before you start
You need an existing status page and permission to edit its DNS zone. Use a subdomain such as status.example.com unless your DNS provider supports the record type required for an apex domain.
Connect the hostname
- Open Status Pages and choose Edit on the page.
- Open the custom-domain section and enter the bare hostname, without
https://or a path. - Save the page.
- Copy the DNS record type, host, and target shown by HowlOps.
- Create that record at your DNS provider.
Do not copy a DNS target from another workspace or from an old tutorial. The API returns the target for the current environment and page.
Follow the state
The configuration screen can report these states:
| State | Meaning |
|---|---|
| Pending DNS | The expected DNS record has not been verified yet. |
| Pending SSL | DNS is visible and certificate provisioning is still running. |
| Active | The hostname is ready over HTTPS. |
| Error | DNS or certificate provisioning failed; inspect the detail shown in the product. |
Provisioning depends on the hosting environment. When automatic certificate management is disabled, HowlOps reports that state instead of pretending the hostname is ready.
Verify and troubleshoot
Check the public hostname only after the page reports Active. If it remains in Pending DNS, query the exact hostname and compare the result with the target shown in HowlOps:
dig status.example.com CNAME
DNS caches respect the TTL from the previous record, so a correct change may not be visible immediately. If DNS matches but the state remains Pending SSL or Error, contact support with the status-page ID and the state shown in the product.
Removing the custom domain does not remove the default /status-page/<slug> URL.
Was this page helpful?