Add PageLens analytics to Hugo
PageLens is cookieless website analytics: no consent banner, a script under 4 KB, real-time stats, funnels, session replay and AI-traffic insights. Setup on Hugo takes about two minutes.
Steps
- If your theme supports it, create
layouts/partials/extend_head.html(PaperMod and others); otherwise copy the theme's head partial intolayouts/partials/. - Paste the snippet into that partial.
- Rebuild with
hugoand deploy.
<script defer src="https://app.pagelens.io/script.js" data-site-id="YOUR_SITE_ID"></script>
Replace YOUR_SITE_ID with the id from your site settings in PageLens. The dashboard shows the exact snippet with your id filled in.
Check that it works
Open your site in a new tab, then open PageLens. The live counter shows your visit within a few seconds. Visits from localhost are ignored by default.
Track custom events
Add data-pagelens-event to any button or form, or call the JavaScript API:
<button data-pagelens-event="signup" data-pagelens-prop-plan="pro">Start trial</button>
<script>
window.pagelens?.track('signup', { plan: 'pro' })
</script>
You can also turn on autocapture for button clicks, form submissions and copy events in Site Settings → Tracking. No code is needed.
Avoid ad blockers
Some ad blockers drop requests to analytics domains. Serve PageLens from your own domain to count those visits too.
Create a free PageLens account: 7-day trial, no card, no cookie banner needed.
Start free trialQuestions
Do I need a cookie banner for analytics on Hugo?
PageLens sets no cookies and stores nothing in the visitor's browser, so it doesn't need a cookie banner of its own. Other scripts on your site may still need one, so check what else you load.
Will it slow down my Hugo site?
The script is under 4 KB and loads with defer, after your page content. It doesn't block rendering.
Can I use it together with Google Analytics?
Yes. PageLens runs next to Google Analytics or any other tool on your Hugo site, so you can compare the numbers before you switch.
How do I see visitors from ChatGPT on my Hugo site?
Visits that come from ChatGPT, Claude, Perplexity and other AI assistants appear as their own channel in your traffic sources, with no setup. To also see which pages AI crawlers read, add a small server snippet or the PageLens Cloudflare Worker: crawlers don't run JavaScript, so only your server sees them.
What does it cost?
There is a 7-day free trial without a card. Plans start at $5 a month.