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.
vercel listUsing the vercel list command to retrieve information
about multiple deployments for the currently-linked Vercel Project.
vercel list [project-name]Using the vercel list command to retrieve information
about deployments for a specific Vercel Project.
vercel list [project-name] [--meta foo=bar]Using the vercel list command to retrieve information
about deployments filtered by metadata.
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.
vercel list --meta key1=value1 key2=value2Using 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.
vercel list --policy canceled=6m -p errored=6m -p preview=6m -p production=6mUsing 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.
vercel list --yesUsing 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.
vercel list my-app --environment=stagingThe 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?