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.

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.

Use the --environment option to list the deployments for a specific environment. This could be production, preview, or a custom environment.

terminal
vercel list my-app --environment=staging

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 March 12, 2025