---

name: session-replay description: Set up session replay for visual debugging. Use when implementing screen recording, replay features, or visual debugging tools. triggers:

• "record user sessions"
• "replay user actions"
• "screen recording"
• "see what user did"
• "set up session replay"
• "visual debugging" priority: 3

---

Session Replay

Capture visual recordings of user sessions for debugging.

When to Use

• Reproducing hard-to-debug issues
• Understanding user confusion
• QA and support investigations

Privacy Requirements (Must Do)

Mask by default:

• All text input fields
• Passwords and sensitive data
• User-generated content
• Financial information
• User photos/documents

Performance Budget

Capture Strategies

Best Practice

Don't record everything. Target:

• Error sessions only (rolling buffer)
• Key user journeys
• 1-10% sampling for general insights

Implementation

See references/session-replay.md for:

• Platform-specific setup
• Privacy masking patterns
• Vendor configurations (Sentry, Datadog)