vercel list
Learn how to list out all recent deployments for the current Vercel Project using the vercel list CLI command.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
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.
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
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.
Was this helpful?