Script Configuration

All available data attributes for customizing the tracking script.

Usage

Configuration is done via data-* attributes on the script tag:

<script
  defer
  data-site="YOUR_SITE_ID"
  data-no-replay
  data-replay-sample-rate="50"
  src="https://revlytics.co/script.js"
></script>

Available options

Attribute	Type	Default	Description
data-site	string	required	Your site ID from the dashboard
data-endpoint	string	auto	Custom API endpoint URL (for self-hosted or local dev)
data-no-replay	flag	—	Disable session replay recording
data-replay-sample-rate	0-100	100	Percentage of sessions to record replay
data-allow-localhost	flag	—	Enable tracking on localhost
data-allow-iframe	flag	—	Enable tracking when embedded in an iframe
data-skip-patterns	JSON	[]	URL patterns to skip entirely
data-mask-patterns	JSON	[]	URL patterns to anonymize
data-allowed-hostnames	string	—	Comma-separated domains for cross-domain tracking

Flag attributes don’t need a value — just their presence enables the feature. For example, data-no-replay (not data-no-replay="true").

Custom endpoint

For self-hosted instances or local development:

<script
  defer
  data-site="YOUR_SITE_ID"
  data-endpoint="https://analytics.yourdomain.com"
  src="https://revlytics.co/script.js"
></script>

The endpoint should be the base URL — the script automatically appends /api/event and /api/replay.

Local development

By default, the script doesn’t track on localhost, 127.0.0.1, or *.local domains. To enable local tracking:

<script
  defer
  data-site="YOUR_SITE_ID"
  data-allow-localhost
  src="https://revlytics.co/script.js"
></script>