My custom domain won't verify

If your client-portal custom domain is stuck on pending or shows "CNAME not detected," the DNS record either hasn't propagated yet or needs a small fix at your DNS provider. The most common culprits are the Cloudflare proxy being on, a leftover A/AAAA record, or trying to use an apex domain.

Work through these

  1. Give it time. DNS changes can take up to an hour. Wait, then click Check DNS again.
  2. Cloudflare? Turn the proxy off for that record (grey cloud, "DNS only"). The orange-cloud proxy blocks verification.
  3. Remove conflicting records. If the subdomain already has an A or AAAA record, delete it — the CNAME can't coexist with it.
  4. Use a subdomain, not an apex. portal.youragency.com works; youragency.com is not supported.
  5. Double-check the record. Type CNAME, name = your subdomain, value = cname.vercel-dns.com.

If it shows "broken"

A previously working domain that shows broken means the CNAME record was changed or removed. Re-add it exactly as above and re-verify.

← Back to Help Center