Skip to content
Docs GitHub

replay

Search and inspect Session Replays

List recent Session Replays

Arguments:

ArgumentDescription
<org/project><org>/, <org>/<project>, or <project> (search)

Options:

OptionDescription
-n, --limit <limit>Number of replays (1-1000) (default: "25")
-q, --query <query>Search query (Sentry replay search syntax)
-e, --environment <environment>...Filter by environment (repeatable, comma-separated)
-s, --sort <sort>Sort by: date, oldest, duration, errors, activity, or a raw replay sort field (default: "date")
-t, --period <period>Time range: "7d", "2026-04-01..2026-05-01", ">=2026-04-01" (default: "7d")
-f, --freshBypass cache, re-detect projects, and fetch fresh data
-c, --cursor <cursor>Navigate pages: "next", "prev", "first" (or raw cursor string)

View a Session Replay

Arguments:

ArgumentDescription
<replay-id-or-url...>[<org>/<project>] <replay-id> or <replay-url>

Options:

OptionDescription
-w, --webOpen in browser
-f, --freshBypass cache, re-detect projects, and fetch fresh data

All commands support --json for machine-readable output and --fields to select specific JSON fields.

Terminal window
# List recent replays for a project
sentry replay list my-org/frontend
# Search across all projects in an org
sentry replay list my-org/ --query "environment:production"
# Change the time window and sort
sentry replay list my-org/frontend --period 24h --sort errors
# Paginate through results
sentry replay list my-org/frontend -c next
sentry replay list my-org/frontend -c prev
# Output machine-readable data
sentry replay list my-org/frontend --json
Terminal window
# View a replay by ID using auto-detected org/project context
sentry replay view 346789a703f6454384f1de473b8b9fcc
# View a replay with an explicit org
sentry replay view my-org/346789a703f6454384f1de473b8b9fcc
# View a replay with explicit org/project context
sentry replay view my-org/frontend/346789a703f6454384f1de473b8b9fcc
# Open a replay in the browser
sentry replay view my-org/346789a703f6454384f1de473b8b9fcc --web