Glossary
Session replay glossary
Core mechanics
- Checkout
A checkout, in rrweb's sense of the word, is a scheduled re-baseline of a recording: the recorder takes a fresh full snapshot mid-session so the event stream contains periodic self-sufficient starting points instead of one ever-growing dependency chain.
- Custom event
A custom event is an application-defined entry in the rrweb event stream (type 5), added via `record.addCustomEvent(tag, payload)`, that timestamps domain context, such as "checkout-started" or "error-shown", alongside the recorded behavior.
- Deserialization
Deserialization in session replay is the reverse of serialization: rebuilding real DOM nodes from the stored data structure so the page can be rendered again inside the player.
- DOM snapshot
A DOM snapshot is a serialized copy of a web page's document object model at one moment: every element, attribute, and text node converted into a data structure that can be stored and later rebuilt into an identical page.
- Event stream
The event stream is the ordered sequence of timestamped events that makes up a session recording, from the opening full snapshot through every incremental change.
- Full snapshot
A full snapshot is the session replay event that captures the complete serialized DOM at a point in time, giving the replayer a self-sufficient starting state.
- Incremental snapshot
An incremental snapshot is a session replay event that records only what changed since the previous event, such as DOM mutations, mouse movement, scrolling, or input values.
- Incremental source
The incremental source is the field inside an rrweb incremental snapshot that identifies what kind of change the event records, distinguishing DOM mutations from mouse movement, clicks, scrolls, viewport resizes, input changes, and other interaction types.
- Live mode
Live mode is replaying a session while it is still being recorded: events stream from the user's browser to a viewer with a short buffer delay, so support or engineering can watch a session in progress.
- Meta event
A meta event is the rrweb event (type 4) that records context about the page rather than its content: the URL, and the viewport width and height at recording start.
- Mirror
The mirror is rrweb's bidirectional mapping between the numeric node ids used in the event stream and the actual DOM nodes, maintained on both the recording and replay sides.
- Mutation observer
In session replay, the mutation observer is the mechanism that watches the page's DOM for changes such as added nodes, removed nodes, and attribute or text edits, so each change can be recorded as an event.
- Replayer
The replayer is the component that turns a stored event stream back into a watchable session: it rebuilds the initial full snapshot, then applies incremental events on a timeline with play, pause, seek, and speed controls.
- rrdom
rrdom is rrweb's virtual DOM implementation: a lightweight, browser-independent model of the document that can apply rrweb events without rendering anything.
- rrweb event
An rrweb event is one entry in a recording's event stream: a JSON object with a numeric `type`, a type-specific `data` payload, and a millisecond `timestamp`.
- Sandboxing
Sandboxing in session replay is the isolation of the rebuilt page inside a restricted iframe so that nothing from the recorded session can execute during playback.
- Serialization
Serialization in session replay is the conversion of live browser state, primarily the DOM tree, into a plain data structure that can be stored, transmitted, and later rebuilt.
- Session recording
Session recording is the capture side of session replay: collecting a user's page state and interactions as structured events while they browse.
- Session replay
Session replay is the reconstruction of a user's visit to a website or application as a watchable playback, built from recorded browser events such as DOM changes, clicks, scrolls, and inputs.
- Skip inactive
Skip inactive is the playback feature that fast-forwards through stretches of a recording where nothing happens, such as a user reading, idling, or leaving the tab.
Behavioral analytics
- Dead click
A dead click is a click that produces no observable response: no DOM change, no navigation, no network activity within a short window after the interaction.
- Drop-off
Drop-off is the point at which users abandon a flow, page, or session, measured as the share who leave at each step rather than continuing.
- Error click
An error click is a click that coincides with a JavaScript error or a failed request, connecting a user's action directly to a technical failure.
- Frustration signal
A frustration signal is any behavioral pattern that indicates a user is struggling, including rage clicks, dead clicks, error clicks, thrashing cursors, rapid back-and-forth navigation, and form field churn.
- Funnel analysis
Funnel analysis measures how users progress through an ordered sequence of steps toward a goal, such as signup or checkout, and where they abandon it.
- Heatmap
A heatmap is an aggregate visualization that overlays interaction density, such as clicks, moves, or scroll reach, onto a page screenshot or rendering, with warmer colors marking higher activity.
- Rage click
A rage click is a burst of repeated rapid clicks on the same element or spot, and it is the most widely used behavioral signal of user frustration.
- Scroll depth
Scroll depth is how far down a page users actually scroll, usually expressed as a percentage of page height or as reach past defined milestones.
- Session segmentation
Session segmentation is filtering and grouping recorded sessions by properties such as page, device, user cohort, presence of errors or frustration signals, funnel stage reached, or custom events.
- Thrashing cursor
A thrashing cursor is fast, erratic, high-amplitude mouse movement without productive interaction, such as circling, zigzagging, or shaking the pointer.
Privacy & compliance
- Consent mode
Consent mode is the practice of gating session recording on the user's consent state: recording starts, stops, or degrades to a minimal mode depending on what the visitor agreed to, usually via the site's consent management platform.
- Data masking
Data masking in session replay is the replacement of sensitive content with placeholders at record time, in the user's browser, so the real values never enter the recording.
- Data residency
Data residency is the requirement that data be stored and processed within a specific geography, such as keeping EU users' session recordings on EU infrastructure.
- GDPR (session replay context)
The GDPR governs session replay whenever recordings capture personal data of people in the EU, which in practice means nearly always.
- PII
PII, personally identifiable information, is any data that identifies a person directly or in combination, such as names, email addresses, phone numbers, government IDs, or precise location.
- Redaction
Redaction is the removal or obscuring of sensitive content from session data, either at capture time or from recordings that already exist.
- Retention policy
A retention policy defines how long session recordings are kept before deletion, and under what rules, such as 30 days for routine sessions and 90 for error sessions.
- Sampling
Sampling in session replay means recording a subset rather than everything, and the word covers two distinct levels: session sampling, capturing only a percentage of sessions, and event sampling, throttling high-frequency event types like mouse moves within a recorded session.
AI & agents
- Accessibility tree
The accessibility tree is the browser's structured representation of a page built for assistive technology: a hierarchy of elements with roles, names, and states, stripped of purely visual detail.
- Action space
An action space is the set of operations an agent can perform on its environment; for web agents, typically click, type, select, scroll, navigate, and wait.
- Agent observability
Agent observability is the practice of capturing what an AI agent did and why, in enough detail to debug, evaluate, and audit its behavior.
- Agent trajectory
An agent trajectory is the complete recorded path of one agent run: the sequence of observations, reasoning steps, actions, and resulting states from task start to termination.
- Behavioral anomaly detection
Behavioral anomaly detection flags sessions that deviate from learned patterns of normal use: impossible speed, inhuman input cadence, paths no legitimate user takes, or sudden population-level shifts.
- Behavioral cloning
Behavioral cloning is the supervised form of imitation learning: train a model to predict the expert's action from the state the expert saw, over a dataset of state-action pairs.
- Behavioral substrate
A behavioral substrate is the foundational data layer that captures how interfaces are used, by humans or by agents, in a form other systems build on.
- Browser agent
A browser agent is an AI system that operates a web browser autonomously to complete tasks: navigating, reading pages, filling forms, and clicking through flows on behalf of a user or another system.
- Computer use
Computer use is the class of AI capability where a model operates a computer the way a person does: viewing the screen or interface state, moving a pointer, clicking, typing, and navigating applications to complete tasks.
- Deterministic action replay
Deterministic action replay is re-executing a recorded sequence of actions against a live or restored environment, as opposed to visual replay, which renders what was recorded without executing anything.
- DOM grounding
DOM grounding is the step where an agent's intended action, expressed in language or coordinates, gets mapped to an actual element in the page: "click the submit button" becomes a specific node.
- Episode
An episode is reinforcement learning's unit of experience: one complete run through an environment from initial state to termination, containing the sequence of states, actions, and rewards.
- Evals
Evals are structured evaluations of AI system behavior: defined tasks, graded outcomes, and comparisons across model versions, prompts, or configurations.
- Imitation learning
Imitation learning trains an agent from demonstrations of a task rather than from trial-and-error reward.
- Intent inference
Intent inference is deriving what a user was trying to accomplish from what they observably did: classifying sessions by goal (compare plans, find an invoice, cancel) from navigation, interaction, and timing patterns.
- LLM session
An LLM session is the grouped record of a multi-step interaction with a language model, linking the individual requests, responses, and tool calls of one task or conversation into a single traceable unit.
- Pixel-based agent
A pixel-based agent perceives interfaces through screenshots, deciding actions from rendered pixels rather than from the DOM or accessibility tree.
- Prompt injection
Prompt injection is an attack where content an AI system processes contains instructions that hijack its behavior: a web page, email, or document tells the model to ignore its task and do something else.
- Semantic session search
Semantic session search is querying a session archive by meaning rather than metadata: "sessions where users struggled to apply a coupon" instead of filters over URLs and dates.
- Session summarization
Session summarization is generating a natural-language account of what happened in a recorded session: the user's apparent goal, the path taken, the friction met, and the outcome.
- Synthetic user
A synthetic user is an AI agent standing in for a human user: exercising flows, testing changes, or generating load by operating the product's real interface.
- Training data
Training data, in the interface-behavior context, is recorded interaction data used to teach models how software is operated: demonstrations of tasks, successful agent trajectories, and human sessions that show real usage patterns.
- World model
A world model is a learned model of how an environment responds to actions: given a state and an action, it predicts the next state.
Technical
- Canvas recording
Canvas recording is the capture of `<canvas>` element content in session recordings.
- Cross-origin iframe
A cross-origin iframe is a frame whose content comes from a different origin than the parent page, such as an embedded payment form, video player, or third-party widget.
- Event compression
Event compression is the reduction of recording payload size before transmission or storage, in rrweb typically via the packer, which deflate-compresses events client-side.
- MutationObserver API
The MutationObserver API is the browser interface that notifies JavaScript of DOM changes, delivering batched records of added and removed nodes, attribute changes, and text edits.
- Shadow DOM
Shadow DOM is the browser feature that gives an element an encapsulated subtree with scoped styles, hidden from normal document traversal; it is the foundation of web components.
- Web worker recording
Web worker recording is the pattern of moving the expensive parts of session recording, such as serialization work, compression, and network transmission, off the page's main thread into a web worker.
- WebSocket ingest
WebSocket ingest is the delivery of recording events to the backend over a persistent socket connection instead of batched HTTP requests.