Session Replay

How It WorksCopy Anchor Link

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

Basic ConfigurationCopy Anchor Link

Session replay is off by default. Turn it on and customize it 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: 0.5        // Record 50% of sessions (default: 1.0, all)
    }
  }
});

Privacy & Data MaskingCopy Anchor Link

Custom MaskingCopy Anchor Link

Mark any element whose text should be masked with data-sensitive, data-private or class="sensitive". To leave an element out of recordings entirely, add class="rr-block".

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

<!-- Inputs are always masked while maskSensitive is on (the default) -->
<input type="text" placeholder="API Key" />

<!-- Leave an entire section out of the recording -->
<section class="rr-block">
  <!-- Not recorded; shown as a placeholder in replays -->
</section>

Sampling (Reduce Costs)Copy Anchor Link

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).

Recording ControlsCopy Anchor Link

Toggle which event types are recorded. Disabling event types you don't need reduces data volume and storage costs.

sessionReplay: {
  enabled: true,

  // Event-type toggles
  recordMousemove: false,   // Mouse movement tracking (default: off)
  recordClick: true,        // Click events (default: on)
  recordScroll: true,       // Scroll events (default: on)
  recordInput: true,        // Form input changes (default: on)
  recordMedia: true,        // Media element events (default: on)
}

Default BehaviorCopy Anchor Link

• recordMousemove is off by default. Mouse movements are typically the largest category of replay data and aren't needed for most click/scroll/funnel analysis. Enable it if you need mouse trail replay.
• All other event types are on by default. The full page is recorded unless you opt into element-level scoping (see next section).

Element-Level Scoping (Advanced, optional)Copy Anchor Link

By default, WysLeap records the entire page. If you need to limit recording to a specific flow (for example, only capturing interactions inside a checkout form for compliance reasons), you can pass an allowlist of CSS selectors to recordElement.

sessionReplay: {
  enabled: true,

  // Default: record the full page (omit or leave empty)
  recordElement: [],

  // Advanced: scope recording to specific elements only.
  // Use this ONLY when you need to limit replays to a specific flow
  // (e.g., a checkout form) for privacy or compliance reasons.
  // Anything outside these selectors will NOT appear in the replay.
  // recordElement: ['#checkout-form', '.payment-section'],
}

When recordElement is set but matches zero elements on a page, WysLeap will log a warning to the browser console naming the selectors, so check DevTools if your replays look empty.

Viewing Session ReplaysCopy Anchor Link

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

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

Next StepsCopy Anchor Link

Need advanced configuration? Learn about privacy and consent settings, sampling, and more configuration options in Advanced Config.