Installing the recorder snippet
The UXSense recorder is one script tag. It records sessions (rrweb, the same open format PostHog uses) and streams them to your project — no other analytics tool required.
Install
Go to Connections → UXSense recorder → Install and copy your snippet. It looks like:
<script src="https://app.uxsense.ai/r.js?id=YOUR_PROJECT_ID" async></script>
Paste it into your site's <head> (or your tag manager). The id ties recordings to your project — use the snippet from your own Connections page, not this example.
For Next.js, put it in your root layout with next/script; for plain HTML, anywhere in <head> works. Deploy, then open your site in a normal browser window and click around for a minute.
Verify it's working
The Connections page shows your session count, and you'll get an email when the first session lands. If nothing arrives after a few minutes:
- Hard-refresh your site (the script is cached; a stale tab may run an old copy).
- Check the browser console for requests to
app.uxsense.aibeing blocked by a CSP — if you run a Content-Security-Policy, allowhttps://app.uxsense.aiinscript-srcandconnect-src. - Confirm the
idin the snippet matches your project (Connections shows the right one).
What gets recorded
DOM snapshots and interactions — clicks, inputs, navigation — enough to replay the session and measure behavior. Text inputs are captured for replay the way rrweb captures them; if you have fields that must never be recorded, add the standard .rr-block class to exclude them.
Volume and sampling
On the free tier, recording stays full-fidelity up to 5,000 sessions per month; past that, deterministic sampling keeps a representative share. Your load map has typically converged long before the ceiling — sampling doesn't change what UXSense knows, and the app tells you when it's active.
← All help articles