PennyLens Documentation

Get PennyLens running in minutes. These docs cover the JavaScript SDK, the event model, session recordings, and the auto-detect layer for Shopify, WooCommerce, and SaaS apps.

Get started

Installation

Add the PennyLens SDK via script tag or npm in under two minutes.

JavaScript SDK

The window.PennyLens API surface — track, identify, pause, reset, recordSession.

Core concepts

Event Tracking

Auto-tracked behavior, custom events, and the property model.

User Identification

Linking anonymous sessions to known users, traits, logout, and GDPR.

Session Recordings

rrweb-based replay — default masking, per-element controls, and retention.

Site types — auto-detect

SaaS events

Reserved event names for signup, activation, engagement, and trial milestones.

WooCommerce

Three-signal auto-detect, dual cart_add listener, and zero-event fallback.

Shopify

Auto-detect for Shopify and Shopify Plus, cart and purchase capture.

Reference

Dashboard reference

Surfaces in the PennyLens dashboard and the data model behind them.