Add Humblytics Analytics to a Custom / Self-Hosted Site
1 · Sign up (or log in)
Visit humblytics.com → Start Free Trial.
Finish signup—or log in to your existing workspace.
2 · Add your website in Humblytics
In the sidebar, click Add Website.
Domain – enter your-domain.com (omit
https://
andwww
).Site Name – internal label (e.g. Marketing‑Prod).
Copy the snippet in Install Tracking Code:
Keep this tab open—we’ll return and click Verify Website once the tag is live.
3 · Paste the script into your code
Static HTML
Add the snippet right before the closing </head>
tag on every page, or include it in a shared header template.
React / Next.js / Vue
Insert the tag in your global layout component (e.g. _document.js
in Next.js, index.html
in Vite/React).
Server‑rendered frameworks (Laravel, Rails, Django, etc.)
Add it to the base layout file that all pages extend—just before </head>
.
Important: The script must run on every page you want tracked.
Deploy or restart your site so the new code is served to visitors.
4 · Verify installation
Return to Humblytics and click Verify Website for your domain.
Open the live site in a private window and refresh once.
Within ~30 seconds you should see a green Verified badge and live visitor count.
If verification fails, check:
The exact domain (staging vs. production).
Script ID matches the one issued for that domain.
Snippet is inside
<head>
and not blocked by CSP or ad‑blockers.
5 · Explore & optimize
Dashboard – traffic, top pages, referrers.
Heatmaps – auto‑generated; reveal click hotspots and scroll depth.
Experiments – run A/B tests without extra libraries (Experiments → New Test).
FAQ – Custom Sites + Humblytics
Question
Answer
Will this slow my site?
No. The tag is about 36 KB, async‑loaded, and served via CDN.
Do I need cookies?
Humblytics is completely cookie‑free—no consent banner required under GDPR.
Can I still use GA or tools?
Yes—Humblytics works alongside other trackers.
Multiple sub‑domains?
Add each sub‑domain as a separate site for isolated dashboards.
You’re all set! Your custom site is now streaming privacy‑first analytics, heatmaps, funnels, and instant A/B testing via Humblytics.
Last updated
Was this helpful?