# Install the recording SDK

**Category:** [Session Replay](https://help.totalctrl.app/hc/totalctrl/totalctrl-help-center/en-US/categories/session-replay)
**Updated:** 2026-08-19

## Step 1: Create a site key

Open **Settings & SDK** and click **New Key**. Give it an optional label such as `Production` or `Staging` so you can tell environments apart, then click **Create Key**. The site key is a public identifier (not a secret) that ties incoming recordings to your account.
## Step 2: Copy the snippet

Once an active key exists, the install snippet appears at the top of the page. Click **Copy** and paste the snippet into the `<head>` of every page you want to record. It loads `session-replay-sdk.js` asynchronously and tags it with your site key.
## Step 3: Identify logged-in users (optional)

To attach a name and email to sessions, call the identify helper anywhere you know who the user is:

- `window.__SR.identify({ id: "user-123", email: "user@example.com" });`

Replace the values with your own server-rendered user data. Identified sessions become searchable by email in the **Sessions** list.
## Step 4: Confirm recording

Visit your site, then open the **Sessions** list in TotalCtrl. New sessions appear with the most recent first. If nothing shows up, confirm the snippet is on the page, the site key is **Active**, and you have not hit your monthly session limit. The site key's **Last Used** column updates whenever data arrives.
## Managing keys

To stop a key from recording, click **Revoke** next to it. Any SDK still using a revoked key will stop sending data immediately.

---

## Related Articles

- [Privacy, masking, and GDPR controls](https://help.totalctrl.app/en-US/articles/privacy-and-gdpr)
- [Getting started: install the recorder](https://help.totalctrl.app/en-US/articles/session-replay-getting-started)
- [Heatmaps & funnels](https://help.totalctrl.app/en-US/articles/session-replay-heatmaps-funnels)
- [Frustration signals: rage clicks, dead clicks, errors & struggle score](https://help.totalctrl.app/en-US/articles/session-replay-signals)
- [Restrict recording to your sites with Allowed origins](https://help.totalctrl.app/en-US/articles/session-replay-allowed-origins)

---
[← Back to TotalCtrl Help Center](https://help.totalctrl.app/en-US/)