vercel list

The vercel list command, which can be shortened to vercel ls, provides a list of recent deployments for the currently-linked Vercel Project.

vercel list

Using the vercel list command to retrieve information about multiple deployments for the currently-linked Vercel Project.

vercel list [project-name]

Using the vercel list command to retrieve information about deployments for a specific Vercel Project.

vercel list [project-name] [--meta foo=bar]

Using the vercel list command to retrieve information about deployments filtered by metadata.

These are options that only apply to the vercel list command, therefore, more information is provided.

The --meta option, shorthand -m, can be used to filter results based on Vercel Project metadata.

vercel list --meta key1=value1 key2=value2

Using the vercel list command with the --meta option.

The --yes option can be used to skip questions you are asked when setting up a new Vercel Project. The questions will be answered with the default scope and current directory for the Vercel Project name and location.

vercel list --yes

Using the vercel list command with the --yes option.

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

• --cwd
• --debug
• --force
• --global-config
• --help
• --local-config
• --scope
• --token

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