Skip to content
Docs

vercel teams

The vercel teams command manages Teams: list teams you belong to, create a new team, switch between teams, invite Team Members, inspect SAML/SSO configuration, list or remove members, and check team join-request status.

vercel switch is a top-level alias for vercel teams switch.

You can manage Teams with further options and greater control from the Vercel Dashboard.

terminal
vercel teams list

Using the vercel teams command to list all teams you're a member of.

List all teams you're a member of.

terminal
vercel teams list [options]
OptionDescription
--nextShow the next page of results. Pass the cursor that the previous page prints.
--limitNumber of teams to return per page. The default is 20, and the maximum is 100.
--jsonOutput the result as JSON.

Show the next page, using the cursor that the previous page prints:

terminal
vercel teams list --next 1584722256178

Create a new team. The interactive flow prompts for slug and display name; in non-interactive mode you must pass both --slug and --name.

terminal
vercel teams create [options]
OptionDescription
--slugTeam URL slug (for example, acme for vercel.com/acme). Required in non-interactive mode.
--nameDisplay name for the team. Required in non-interactive mode.

Create a team interactively:

terminal
vercel teams create

Create a team non-interactively:

terminal
vercel teams create --slug acme --name "Acme Corp"

Invite one or more new members to the current team. In non-interactive mode you must pass at least one email address.

terminal
vercel teams invite [email...]

Invite interactively:

terminal
vercel teams invite

Invite multiple members (required form in non-interactive mode):

terminal
vercel teams invite abc@vercel.com xyz@vercel.com

Switch your CLI context to a different team. If the slug is omitted, the command is interactive. Available as the top-level alias vercel switch.

switch does not accept the global --token flag; use the global --scope flag if you need to override scope for a single command.

terminal
vercel teams switch [slug]

Switch to a team by slug (if your team's URL is vercel.com/name, then name is the slug):

terminal
vercel teams switch acme

Switch interactively:

terminal
vercel teams switch

Show the join-request status for the current team. Defaults to the authenticated user; pass a user ID to check another user's request.

terminal
vercel teams request [userId] [options]
OptionDescription
--jsonOutput the result as JSON.

Status for your pending request:

terminal
vercel teams request

Status for another user ID:

terminal
vercel teams request user_abc123

Show the SAML/SSO configuration for the currently scoped team.

terminal
vercel teams sso [options]
OptionDescription
--jsonOutput the result as JSON.

Human-readable SAML summary:

terminal
vercel teams sso

JSON output:

terminal
vercel teams sso --json

List the members of the currently scoped team, or remove a member from it. To invite a member, use invite.

terminal
vercel teams members [options]
vercel teams members remove <member>

To remove a member, pass their email, username, or user ID. The command shows the team and the member, then asks you to confirm. No option skips this prompt, so run the command in an interactive terminal. If the team's invoices go to that member, the command first asks you for a new invoice recipient.

OptionDescription
--nextShow the next page of results. Pass the cursor that the previous page prints.
--limitNumber of members to return per page. The default is 20, and the maximum is 100.
--jsonOutput the result as JSON.
terminal
# List team members
vercel teams members
 
# List team members as JSON
vercel teams members --json
 
# Paginate results
vercel teams members --next 1584722256178
 
# Remove a member
vercel teams members remove user@example.com

The following global options can be passed when using the vercel teams command:

For more information on global options and their usage, refer to the options section.

Last updated August 11, 2026

Was this helpful?

supported.