How to attach a custom domain to a status page
Summary
Section titled “Summary”On the page detail Custom domain card, edit the Hostname, save, then create the DNS records shown (or in Vercel Domains).
Who can do this: Owner or Admin. Requires custom domains entitlement and available hostname capacity.
Prerequisites
Section titled “Prerequisites”A status page. Plan includes custom domains. DNS access at your provider.
- Open Settings → Pages and select the page.
- Find Custom domain. If empty, it shows No custom domain — click edit to add one.
- Click the edit control (Edit hostname).
- Enter Hostname (e.g.
status.example.com— nohttps://, apex roots not allowed). - Click Save.
- Create the DNS records listed (or follow the Vercel Domains fallback instructions).
- If status is not Active, use Refresh DNS verification until it becomes Active.
[Screenshot: Custom domain card with hostname, status pill, and DNS records]
Result
Section titled “Result”When status is Active, visitors can open the status page on your hostname.
Troubleshooting
Section titled “Troubleshooting”- Statuses include Inactive, Pending verification, Active, Error.
- If DNS rows stay empty, use the Vercel project Settings → Domains page as authoritative.
Related articles
Section titled “Related articles”Sources (for verification)
Section titled “Sources (for verification)”src/components/admin/pages/status-page-custom-domain-panel.tsxmessages/en.json → admin.statusPageCustomDomaindocs/custom-domains-and-private-access.md

