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

vercel list [project-name]

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

vercel list [project-name] [--policy errored=6m]

These are options that only apply to the vercel list command.

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

vercel list --meta key1=value1 key2=value2

The --policy option, shorthand -p, can be used to display expiration based on Vercel project deployment retention policy.

vercel list --policy canceled=6m -p errored=6m -p preview=6m -p production=6m

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

Use the --environment option to list the deployments for a specific environment. This could be production, preview, or a custom environment. For more information, see Using an environment through the Vercel CLI.

vercel list my-app --environment=staging

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

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

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