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.