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.

Custom e-commerce

Wire product_view, cart_add, checkout_step, and purchase for any storefront — headless, custom, or WooCommerce.

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.