Vercel CLI 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

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

vercel --debug

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

vercel --global-config /path-to/global-config-directory

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

vercel --help

vercel alias --help

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

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

The --scope option, shorthand -S, can be used to execute Vercel CLI commands from a scope that’s not currently active.

vercel --scope my-team-slug

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

vercel --token iZJb2oftmY4ab12HBzyBXMkp

The --no-color option, or NO_COLOR=1 environment variable, can be used to execute Vercel CLI commands with no color or emoji output. This respects the NO_COLOR standard.

vercel login --no-color

The --team option, shorthand -T, can be used to specify a team slug or ID for the command. This is useful when you need to run a command against a specific team without switching scope.

vercel list --team my-team-slug

vercel deploy -T team_abc123def

The --version option, shorthand -v, outputs the current version number of Vercel CLI.

vercel --version