> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ghostlyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Session replay

> Record and replay real visitor sessions to understand how people use your site.

<Note>
  Session replay requires the **Business plan** or above.
</Note>

## Privacy defaults

Session replay in GhostlyX is privacy-first by default:

* All text content is masked before capture. GhostlyX records layout and interaction patterns, not the actual text visitors type or read
* Images are masked
* No IP addresses are stored
* Only CSS and layout information is captured. No screenshots or video are transmitted

These defaults cannot be disabled. They are not a setting.

## Enabling session replay

1. Go to **Settings** for your site.
2. Toggle **Session replay** on.
3. Set a **sampling rate**. The default is **10%**. GhostlyX will record approximately 1 in 10 sessions. Increase this if you need more data; decrease it to reduce storage usage.
4. Save settings.

Recording begins for new sessions within a few minutes.

## The replay player

Open a recording from **Analytics > Sessions**. The player includes:

* **Timeline**: scrub to any point in the session
* **Playback speed**: 0.5x, 1x, 2x, 4x
* **Event log**: a sidebar listing every click, scroll, and navigation event with timestamps
* **UX signals**: highlights of rage clicks, dead clicks, U-turns, and JavaScript errors

## UX signals

| Signal     | Definition                                                      |
| ---------- | --------------------------------------------------------------- |
| Rage click | Three or more clicks in the same area within 1 second           |
| Dead click | A click on an element that triggers no response                 |
| U-turn     | Visitor navigates to a page and immediately navigates back      |
| JS error   | An unhandled JavaScript exception was thrown during the session |

## Filtering recordings

Filter the recordings list by UX signal, entry page, device type, country, or date range to find the sessions most relevant to what you are investigating.

## Retention

Recordings are retained for 90 days and automatically deleted after that period.