Skip to content

Global options

Learn about Vercel CLI's global options.

Global options are commonly available to use with multiple Vercel CLI commands.

The --cwd option can be used to provide a working directory (that can be different from the current directory) when running Vercel CLI commands.

This option can be a relative or absolute path.

vercel --cwd ~/path-to/project

Using the vercel command with the --cwd option.

The --debug option, shorthand -d, can be used to provide a more verbose output when running Vercel CLI commands.

vercel --debug

Using the vercel command with the --debug option.

The --force option, shorthand -f, is used to skip the build cache.

The option can also be used with vercel init to forcibly replace an existing local directory.

vercel --force

Using the vercel command with the --force option.

vercel init gatsby my-project-directory --force

Using the vercel init command with the --force option.

The --global-config option, shorthand -Q, can be used set the path to the global /.vercel directory.

vercel --global-config /path-to/.vercel

Using the vercel command with the --global-config option.

The --help option, shorthand -h, can be used to display more information about Vercel CLI commands.

vercel --help

Using the vercel command with the --help option.

vercel alias --help

Using the vercel alias command with the --help option.

The --local-config option, shorthand -A, can be used set the path to a local vercel.json file.

vercel --local-config /path-to/vercel.json

Using the vercel command with the --local-config option.

The --scope option, shorthand -S, can be used to execute Vercel CLI commands from a different team or user account than is currently active.

vercel --scope my-team-slug

Using the vercel command with the --scope option.

The --token option, shorthand -t, can be used to execute Vercel CLI commands with an authorization token.

vercel --token iZJb2oftmY4ab12HBzyBXMkp

Using the vercel command with the --token option.