vercel list

Learn how to list out all recent deployments for the current Vercel Project using the vercel list CLI command.
Table of Contents

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

terminal
vercel list

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

terminal
vercel list [project-name]

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

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

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

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

Using the vercel list command to retrieve information about deployments including retention policy.

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.

terminal
vercel list --meta key1=value1 key2=value2

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

To see the meta values for a deployment, use GET /deployments/{idOrUrl}.

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

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

Using the vercel list command with the --policy 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.

terminal
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:

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

Last updated on August 24, 2024