Add Humblytics Analytics to a Custom / Self-Hosted Site

1 · Sign up (or log in)

  1. Visit humblytics.comStart Free Trial.

  2. Finish signup—or log in to your existing workspace.


2 · Add your website in Humblytics

  1. In the sidebar, click Add Website.

  2. Domain – enter your-domain.com (omit https:// and www).

  3. Site Name – internal label (e.g. Marketing‑Prod).

  4. Copy the snippet in Install Tracking Code:


<!-- Start Humblytics Tracking Code -->
<script async src="https://app.humblytics.com/hmbl.min.js?id=e8b9a71"></script>
<!-- End Humblytics Tracking Code -->
  1. 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

  1. Return to Humblytics and click Verify Website for your domain.

  2. Open the live site in a private window and refresh once.

  3. 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?