You can now use the Vercel CLI to diagnose a domain's DNS configuration.

Using the vercel domains verify command, you can check whether a domain is correctly configured, attached to the right project, and verified. If not, it returns the exact steps to fix it.

▲ vercel domains verify example.com --project my-site

> Checked example.com under my-team 1.23s

Status

DNS Configuration ✘ Invalid Configuration

Project ✔ Verified for my-site

What to fix

1. Point example.com to Vercel with one of the following options:

a) Add an A record:

A @ 76.76.21.21

b) Switch to the Vercel nameservers:

ns1.vercel-dns.com

ns2.vercel-dns.com

Currently resolves to

Type Value

A 1.2.3.4

Nameservers

ns1.provider.com

ns2.provider.com

vercel domains verify output showing an invalid DNS configuration.

vercel domains verify inspects ownership, DNS records, nameservers, DNSSEC, conflicting records, and project attachment, and tells you precisely what to change. When the domain is correctly configured, you get a single line back:

▲ vercel domains verify example.com --project my-site

> Success! Valid Configuration: example.com is configured (A record) and verified for project my-site 0.41s

Output when the domain is correctly configured and verified.

With --format json, the command returns the full diagnosis: status, reason, recommended records, detected conflicts, and suggested next commands. It exits non-zero when misconfigured or unverified, making it scriptable for CI and automation:

▲ vercel domains verify example.com --format json

{

"status":"action_required",

"reason":"invalid_configuration",

"message":"example.com has an invalid DNS configuration. Apply the recommended DNS changes, then retry verification.",

"ok":false,

"recommended":{

"records":[

{

"type":"A",

"name":"@",

"value":"76.76.21.21"

}

],

"nameservers":[

"ns1.vercel-dns.com",

"ns2.vercel-dns.com"

]

},

"conflicts":[],

"next":[

{

"command":"vercel domains verify example.com",

"when":"Re-check after completing the required changes"

}

]

}

Full JSON diagnosis including status, reason, recommended records, and suggested next commands.

You can also scope to a project, enforce exact matching, or run non-interactively:

vercel domains verify example.com --project my-site

vercel domains verify example.com --strict

vercel domains verify example.com --format json

vercel domains verify example.com --non-interactive

vercel domains verify --help

Common vercel domains verify flags.

Upgrade your Vercel CLI to version 54.15.1 to get started. Learn more in the vercel domains verify documentation.