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 list

vercel list [project-name]

vercel list [project-name] [--status READY,BUILDING]

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

The --status option, shorthand -s, can be used to filter deployments by their status.

vercel list --status READY

You can filter by multiple status values using comma-separated values:

vercel list --status READY,BUILDING

The supported status values are:

• BUILDING - Deployments currently being built
• ERROR - Deployments that failed during build or runtime
• INITIALIZING - Deployments in the initialization phase
• QUEUED - Deployments waiting to be built
• READY - Successfully deployed and available
• CANCELED - Deployments that were canceled before completion

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=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.