---
title: vercel switch
product: vercel
url: /docs/cli/switch
canonical_url: "https://vercel.com/docs/cli/switch"
last_updated: 2026-04-10
type: reference
prerequisites:
  - /docs/cli
related:
  []
summary: Learn how to switch between different team scopes using the vercel switch CLI command.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# vercel switch

The `vercel switch` command is used to switch to a different team scope when logged in with Vercel CLI. You can choose to select a team from a list of all those you are part of or specify a team when entering the command.


<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [How do I select a team on Vercel?](https://vercel.com/kb/guide/how-do-i-select-a-team-on-vercel?from=related) — Information on selecting a team on Vercel.
- [vercel teams](https://vercel.com/docs/cli/teams?from=related) — Learn how to list, add, switch, invite, and manage your teams with the vercel teams CLI command.
- [vercel login](https://vercel.com/docs/cli/login?from=related) — Learn how to login into your Vercel account using the vercel login CLI command.
- [vercel dev](https://vercel.com/docs/cli/dev?from=related) — Learn how to replicate the Vercel deployment environment locally and test your Vercel Project before deploying using the
- [Global Options](https://vercel.com/docs/cli/global-options?from=related) — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
- [Project Linking](https://vercel.com/docs/cli/project-linking?from=related) — Learn how to link existing Vercel Projects with Vercel CLI.

Full cross-link map for this page: [/docs/cli/switch.graph.md](/docs/cli/switch.graph.md)
<!-- /docsgraph:related -->

## Usage

```bash filename="terminal"
vercel switch
```

*Using the \`vercel switch\` command to change team scope with Vercel CLI.*

## Extended Usage

```bash filename="terminal"
vercel switch [team-name]
```

*Using the \`vercel switch\` command to change to a specific team scope with
Vercel CLI.*


---

[View full sitemap](/docs/sitemap)