Command Palette

Search for a command to run...

vercel_list

Display recent deployments for linked project

Aliases
vercel ls
Syntax
vercel list [project-name] [options]
Options
Available flags and parameters for this command
--meta / -m

Filter by metadata (key=value pairs)

--policy / -p

Show expiration info based on retention policies

--status / -s

Filter by status (READY, BUILDING, ERROR, etc.)

--environment

Filter by environment (production, preview, custom)

--yes

Skip confirmation prompts

Examples
Common usage examples
vercel list --status READY
vercel list --meta env=staging
vercel list my-app --environment=production
vercel list --policy canceled=6m errored=6m
Use Cases
When to use this command
  • •View deployment history
  • •Filter deployments by status
  • •Check deployment metadata
  • •Monitor build states