Skip to content
VercelVercel
'; user_status_content.firstChild.appendChild(avatarContainer); } else { // Placeholder for LoggedOutUserMenu let loggedOutContainer = document.createElement('div'); // if LoggedOutUserMenu fallback let userBtn = document.createElement('button'); userBtn.style.width = "33px"; userBtn.style.height = "33px"; userBtn.style.display = "flex"; userBtn.style.alignItems = "center"; userBtn.style.justifyContent = "center"; userBtn.style.color = "var(--ds-gray-900)"; userBtn.style.border = "1px solid var(--ds-gray-300)"; userBtn.style.borderRadius = "100%"; userBtn.style.cursor = "pointer"; userBtn.style.background = "transparent"; userBtn.style.padding = "0"; // user icon ( from geist) let svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); svg.setAttribute('data-testid', 'geist-icon'); svg.setAttribute('height', '16'); svg.setAttribute('stroke-linejoin', 'round'); svg.setAttribute('style', 'color:currentColor'); svg.setAttribute('viewBox', '0 0 16 16'); svg.setAttribute('width', '16'); let path = document.createElementNS('http://www.w3.org/2000/svg', 'path'); path.setAttribute('fill-rule', 'evenodd'); path.setAttribute('clip-rule', 'evenodd'); path.setAttribute('d', 'M7.75 0C5.95507 0 4.5 1.45507 4.5 3.25V3.75C4.5 5.54493 5.95507 7 7.75 7H8.25C10.0449 7 11.5 5.54493 11.5 3.75V3.25C11.5 1.45507 10.0449 0 8.25 0H7.75ZM6 3.25C6 2.2835 6.7835 1.5 7.75 1.5H8.25C9.2165 1.5 10 2.2835 10 3.25V3.75C10 4.7165 9.2165 5.5 8.25 5.5H7.75C6.7835 5.5 6 4.7165 6 3.75V3.25ZM2.5 14.5V13.1709C3.31958 11.5377 4.99308 10.5 6.82945 10.5H9.17055C11.0069 10.5 12.6804 11.5377 13.5 13.1709V14.5H2.5ZM6.82945 9C4.35483 9 2.10604 10.4388 1.06903 12.6857L1 12.8353V13V15.25V16H1.75H14.25H15V15.25V13V12.8353L14.931 12.6857C13.894 10.4388 11.6452 9 9.17055 9H6.82945Z'); path.setAttribute('fill', 'currentColor'); svg.appendChild(path); userBtn.appendChild(svg); loggedOutContainer.appendChild(userBtn); loggedOutContainer.style.display = 'flex'; loggedOutContainer.style.gap = '8px'; loggedOutContainer.style.alignItems = 'center'; user_status_content.firstChild.appendChild(loggedOutContainer); } })();
Menu

Vercel CLI Global Options

Last updated March 17, 2026

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

Current Working Directory

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.

terminal
vercel --cwd ~/path-to/project

Using the vercel command with the --cwd option.

Debug

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

terminal
vercel --debug

Using the vercel command with the --debug option.

Global config

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

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

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

Help

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

terminal
vercel --help

Using the vercel command with the --help option.

terminal
vercel alias --help

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

Local config

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

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

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

Scope

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

terminal
vercel --scope my-team-slug

Using the vercel command with the --scope option.

Project

You can specify which Vercel Project to use for a CLI command in three ways:

  1. --project flag: Pass a project name or ID directly to the command
  2. VERCEL_PROJECT_ID environment variable: Set the project ID as an environment variable
  3. Project linking: Use the .vercel directory created by vercel link

If you provide multiple options, the CLI uses this precedence order (highest to lowest):

  1. --project flag
  2. VERCEL_PROJECT_ID environment variable
  3. .vercel/project.json from project linking
terminal
# Using the --project flag with a project name
vercel deploy --project my-project
 
# Using the --project flag with a project ID
vercel deploy --project prj_abc123
 
# Using the environment variable
VERCEL_PROJECT_ID=prj_abc123 vercel deploy

Different ways to specify the project for a Vercel CLI command.

The --project flag and VERCEL_PROJECT_ID both accept a project name or project ID. When using CI/CD pipelines or non-interactive environments, set VERCEL_ORG_ID and VERCEL_PROJECT_ID as environment variables to skip project linking. See using Vercel CLI for custom workflows for more details.

Token

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

terminal
vercel --token iZJb2oftmY4ab12HBzyBXMkp

Using the vercel command with the --token option.

No Color

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.

terminal
vercel login --no-color

Using the vercel command with the --no-color option.

Team

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.

terminal
vercel list --team my-team-slug

Using the vercel command with the --team option.

terminal
vercel deploy -T team_abc123def

Using the vercel command with the -T shorthand to specify a team by ID.

Version

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

terminal
vercel --version

Using the vercel command with the --version option to display the CLI version.

Previous
Telemetry
Next
vercel activity

Was this helpful?

supported.