Session Replay

Session replay records DOM mutations and user interactions using rrweb. Recordings are serialized events, not video.

Enable Replay

Turn it on with the object form.

<Analytics siteKey="your_site_key" sessionReplays={{ enabled: true }} />

faststats: {
	siteKey: "your_site_key",
	sessionReplays: { enabled: true },
}

new WebAnalytics({
	siteKey: "your_site_key",
	sessionReplays: { enabled: true },
});

Batching

Replay events are buffered in the browser and uploaded in chunks. The defaults prefer fewer, larger chunks so a normal one-minute replay should usually create single-digit storage objects instead of dozens.

sessionReplays: { enabled: true },
replayOptions: {
	flushInterval: 5_000,
	maxEvents: 1000,
	maxBatchSizeBytes: 512 * 1024,
}

The collector coalesces these small reliable browser flushes into fewer storage objects. The recorder still flushes early on page hide, session rotation, periodic full snapshots, and when a batch reaches the byte limit.

Privacy and Masking

The recorder masks inputs by default and lets you hide elements with replayOptions.

new WebAnalytics({
	siteKey: "your_site_key",
	sessionReplays: { enabled: true },
	replayOptions: {
		maskAllInputs: true,
		maskTextSelector: ".sensitive",
		blockSelector: ".no-record",
	},
});

Any element you mark with the block selector is replaced with a placeholder, so its content never leaves the browser.

Cookieless Behavior

Replay follows your consent setup. In cookieless or denied mode the recorder stops and clears any buffered events, so nothing is recorded until consent is granted. See Consent and Cookieless.