Custom domain troubleshooting

Use this when Bool still shows Pending or Error after you saved DNS.

Checklist

Confirm the exact record
- Type: CNAME
- Host / Name: www (not @, not www.yourdomain.com)
- Value / Target: cname.vercel-dns.com
Remove conflicts — only one routing record should exist for www. Delete old A/AAAA/CNAME/parking records for that host.
Cloudflare users — Proxy status must be DNS only (gray cloud), not Proxied (orange cloud). See Cloudflare.
Wait for propagation — many registrars update in under an hour; worst case is ~48 hours.
Click Refresh in Bool — status does not flip automatically; verification runs when you refresh.

From a terminal:


dig CNAME www.yourdomain.com +short

You want a result that includes cname.vercel-dns.com (sometimes with a trailing dot).

For apex domains:


dig A yourdomain.com +short

You want 76.76.21.21 when following the apex A record path.

What you see	Likely cause	Fix
DNS isn’t pointing at Vercel yet	Record missing, wrong value, or still propagating	Recheck host/value; wait; Refresh again
Add a TXT record to prove ownership	Domain was claimed elsewhere / needs ownership proof	Add the exact TXT record Bool (via Vercel) shows, then Refresh
Redirect loop / certificate error	Cloudflare orange-cloud proxy, or mixed old + new records	Set DNS only; delete parking/`www` conflicts
Site still shows a parking page	Default registrar parking records remain	Delete parking / default www records, keep only the Bool CNAME

Double-check you added the domain in Bool as www.yourdomain.com (or whatever hostname you configured in DNS).
Make sure the Bool is published.
Try the domain in a private browser window after status is Active (to avoid cached DNS or HSTS from an old site).