vercel activity
The vercel activity command displays activity events for your linked project. You can filter events by type, date range, and project, or view all events across your team.
By default, running vercel activity shows events scoped to the linked project. Use --all to see all events across your team, or --project to target a specific project. The output shows which project or team the events are for.
# List events for the linked project
vercel activity
# List all team events from the last 30 days
vercel activity --all --since 30d
# Filter by event type
vercel activity --type deployment --since 7dUsing the vercel activity command to view activity events.
These options only apply to the vercel activity command.
The --type option filters events by event type. You can repeat the flag or use comma-separated values. Run vercel activity types to see all available event types.
# Single type
vercel activity --type deployment
# Multiple types with repeated flags
vercel activity --type deployment --type project-created
# Comma-separated types
vercel activity --type deployment,project-createdThe --since option, shorthand -s, shows events after a specific date. You can use ISO 8601 format or relative values like 1d, 7d, or 30d.
vercel activity --since 7d
vercel activity --since 2026-01-01T00:00:00ZThe --until option, shorthand -u, shows events before a specific date. Accepts the same formats as --since.
vercel activity --since 30d --until 7dThe --project option, shorthand -p, filters events by a specific project name or ID. This overrides the auto-detected linked project.
vercel activity --project my-appThe --all option, shorthand -a, shows all events across your team instead of scoping to the linked project.
vercel activity --all --since 30dYou can't use --all and --project together.
The --limit option specifies the maximum number of events to return. The default is 20, and the maximum is 100.
vercel activity --limit 50The --next option paginates through results. After each page, the command prints the value to pass to --next for the following page.
vercel activity --next 1706140800000The --json option prints the events as JSON, which makes it easier to pipe to other tools like jq:
vercel activity --json | jq '.events[]'The JSON output also includes a scope object that shows which project or team the events are for. It has the teamSlug and, when the events are for one project, the projectName and projectIds:
vercel activity --json | jq '.scope'Lists all available event types with descriptions. Use this to find valid values for the --type filter.
vercel activity types
vercel activity types --jsonList deployment events from the last week:
vercel activity --type deployment --since 7dList all team events and output as JSON:
vercel activity --all --json | jq '.events[] | {type, text: .text}'Paginate through results:
vercel activity --limit 10
# Use the --next value from the output to get the next page
vercel activity --limit 10 --next 1706140800000The following global options can be passed when using the vercel activity command:
For more information on global options and their usage, refer to the options section.
Was this helpful?