Documentation
Welcome to Uplytics documentation. Choose a topic from the sidebar or read below.
Install the tracker
In Uplytics, open a project → Settings. Copy the telemetry snippet into your site's <head>.
<script src="https://uplytics.space/tracker.js" data-site-id="ak_…" defer></script>
- Use the site key (
ak_…) from Settings — not only the internal id. - Works with SPAs:
pushState/popstatesend new pageviews. - Custom events:
window.uplytics.event('signup', { plan: 'pro' })
Use Start live check on Settings to wait for the first pageview.
Uptime how-it-works
Every 5 minutes, our uptime runner requests each site's uptime URL (HEAD by default, or GET if you select it in Settings).
- Private IPs and metadata endpoints are blocked (SSRF protection).
- After 3 consecutive failures we open an incident and send a down alert.
- When the site recovers, we send a recovery email and resolve the incident.
Alerts
Configure on project Settings:
- Alert email — defaults to your Clerk primary email if empty.
- Slack / Discord webhook — HTTPS incoming webhook URL.
Custom events
Send lightweight events after the tracker loads:
window.uplytics && window.uplytics.event('purchase', { amount: 49 })Events appear in Analytics alongside your pageview counts.
Privacy & GDPR
We do not store IP addresses or set third-party cross-site cookies. Visitor IDs rotate naturally. Export or delete all account data in Account.
AppSumo & license codes
Redeem codes on Account or /redeem. Codes stack automatically toward higher lifetime tiers.