Skip to content

How to attach a custom domain to a status page

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.

A status page. Plan includes custom domains. DNS access at your provider.

  1. Open Settings → Pages and select the page.
  2. Find Custom domain. If empty, it shows No custom domain — click edit to add one.
  3. Click the edit control (Edit hostname).
  4. Enter Hostname (e.g. status.example.com — no https://, apex roots not allowed).
  5. Click Save.
  6. Create the DNS records listed (or follow the Vercel Domains fallback instructions).
  7. If status is not Active, use Refresh DNS verification until it becomes Active.

[Screenshot: Custom domain card with hostname, status pill, and DNS records]

When status is Active, visitors can open the status page on your hostname.

  • Statuses include Inactive, Pending verification, Active, Error.
  • If DNS rows stay empty, use the Vercel project Settings → Domains page as authoritative.
  • src/components/admin/pages/status-page-custom-domain-panel.tsx
  • messages/en.json → admin.statusPageCustomDomain
  • docs/custom-domains-and-private-access.md