Skip to main content
Apply privacy controls in the browser so sensitive values never reach the network. Start with the default masked mode and allow additional content only after reviewing the recorded result.

Privacy-safe defaults

With these defaults:
  • URL query strings and fragments are removed;
  • keys such as password, secret, token, authorization, cookie, api_key, and credit-card fields are recursively redacted from context;
  • interaction labels and raw error stacks are withheld in masked mode;
  • DOM text is masked during session replay;
  • all input and contenteditable values remain masked, including when visible page text is allowed.
Field-name redaction is a safety net, not a data-classification system. Do not add credentials, payment data, health data, or unnecessary personal information to user or custom context objects.

Block or mask DOM content

The SDK recognizes privacy attributes without application-specific recorder code:
Replace the default selectors when needed:
Use blocking for secrets or large sensitive widgets, masking for text whose layout is useful, and ignoring for noisy elements that have no investigation value.

Allow visible page text carefully

Set defaultPrivacyLevel: 'allow' only after marking every sensitive region. Input values are still masked, and the configured maskTextSelector plus contenteditable elements remain masked.

Control URLs and network collection

Keep trackUrlQueryString: false unless the application guarantees that queries never contain identifiers or secrets. Exclude sensitive routes or network endpoints before collection:
allowedTracingUrls controls which origins can contribute trace context. The option does not enable request or response body capture; the SDK records timing and sanitized URL metadata.

Review before production

1

Record a controlled test session

Exercise sign-in, checkout, profile, search, and error flows with non-production test data.
2

Inspect every event surface

Review session metadata, action names, URLs, error stacks, custom context, and DOM replay.
3

Add selectors and exclusions

Block sensitive subtrees and exclude routes that do not need collection.
4

Repeat after UI changes

Treat privacy selectors as production configuration and test selector behavior after markup changes.

Session replay

Configure DOM recording after defining the privacy boundary.
Last modified on August 5, 2026