Skip to content

vercel list

Learn how to list out all recent deployments for the current project from the command line.

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

vercel list

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

vercel list [project-name]

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

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

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

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

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

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

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 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 project. The questions will be answered with the default scope and current directory for the project name and location.

vercel list --yes

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