vercel domains

The vercel domains command manages domains under the current scope. With it, you can list, inspect, verify, add, remove, purchase, renew, move, transfer in, search, price, check the availability of, and manage automatic renewal for domains.

vercel domains ls

vercel domains inspect [domain]

vercel domains verify [domain]

vercel domains add [domain] [project]

vercel domains rm [domain]

vercel domains buy [domain]

vercel domains search [query]

vercel domains price [domain] [...domain]

vercel domains check [domain] [...domain]

vercel domains move [domain] [scope-name]

vercel domains transfer-in [domain]

vercel domains renew [domain]

vercel domains auto-renew [domain] [on|off]

These are options that only apply to the vercel domains command.

Use the --yes option to bypass the confirmation prompt when removing a domain.

vercel domains rm [domain] --yes

Use the --limit option to specify the maximum number of domains that ls returns. The default value is 20 and the maximum is 100.

vercel domains ls --limit 100

You can also use the --limit option with search to specify the number of domain candidates to check per page. The default value is 20 and the maximum is 200.

vercel domains search acme --limit 200

The --next option enables pagination when listing domains. Pass the timestamp (in milliseconds since the UNIX epoch) from a previous response to get the next page of results.

vercel domains ls --next 1584722256178

You can also use the --next option with search to fetch the next page of candidates. Pass the cursor returned in the previous search response or printed in the continuation command.

vercel domains search acme --next [cursor]

The --force option forces a domain on a project, removing it from an existing one.

vercel domains add my-domain.com my-project --force

Use the --available option with search to show only domain candidates that are available to register.

vercel domains search acme --available

Use the --order option with search to order candidates by relevance, alphabetical, or length. The default value is relevance.

vercel domains search acme --order alphabetical

Use the --tld option with search to filter candidates by exact top-level domain. Repeat the option to search multiple TLDs.

vercel domains search acme --tld com --tld dev

Use the --format=json option with search to return structured JSON output.

vercel domains search acme --format=json

You can also use the --format=json option with verify to return structured JSON output describing the current and expected DNS records for the domain.

vercel domains verify my-domain.com --format=json

You can also use the --format=json option with renew to print the renewal result as structured JSON. The renewal still requires an interactive confirmation of the charge before the JSON result is printed.

vercel domains renew my-domain.com --format=json

You can also use the --format=json option with auto-renew to return a structured JSON result describing the domain's new automatic renewal state.

vercel domains auto-renew my-domain.com on --format=json

Use the --project option with verify to check the DNS configuration against the records expected by a specific Vercel Project.

vercel domains verify my-domain.com --project my-project

Use the --strict option with verify to check DNS for the exact domain only, without falling back to the parent zone's configuration.

vercel domains verify my-domain.com --strict

The following global options can be passed when using the vercel domains command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --team
• --token
• --version

For more information on global options and their usage, refer to the options section.