Session Replay

Record and replay user sessions to understand behavior, debug issues, and improve UX. Session replay is enabled by default.

How It Works

Event-based recording (not video) for smaller data footprint
DOM snapshots + mouse movements + clicks + scrolls + form inputs
Pixel-perfect replay of user interactions
GDPR compliant with automatic sensitive data masking

Basic Configuration

Session replay is enabled by default. You can customize settings in your init code:

WysLeap.init({
  siteId: 'your-site-id',
  options: {
    _apiKey: 'your-api-key',
    sessionReplay: {
      enabled: true,         // Enable/disable session replay
      maskSensitive: true,   // Auto-mask passwords, emails, etc.
      sampleRate: 1.0        // Record 100% of sessions
    }
  }
});

Privacy & Data Masking

Automatic Sensitive Data Masking

When maskSensitive: true, these fields are automatically masked:

Password inputs (type="password")
Email inputs (type="email")
Credit card inputs (detected by pattern)
Any input with data-wysleap-mask attribute

Custom Masking

Add data-wysleap-mask to any element to mask its content:

<!-- Mask sensitive text content -->
<div data-wysleap-mask>
  User's SSN: 123-45-6789
</div>

<!-- Mask input field -->
<input type="text" data-wysleap-mask placeholder="API Key" />

<!-- Mask entire section -->
<section data-wysleap-mask>
  <!-- Everything inside will be masked -->
</section>

Sampling (Reduce Costs)

Record a fraction of sessions to reduce data usage and costs:

sessionReplay: {
  enabled: true,
  sampleRate: 0.5  // Record 50% of sessions
}

Note: Sampling is deterministic per session (same visitor always gets same decision).

Viewing Session Replays

Once session replay is enabled, you can view recordings in your analytics dashboard:

Navigate to Analytics Dashboard
Click on any visitor or session
Click "Watch Replay" to see the full session recording

Need Advanced Configuration?

Learn about advanced settings, custom identifiers, and more configuration options.

Next: Advanced Config

Onboarding Guide