Add PageLens analytics to Astro
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 Astro takes about two minutes.
Steps
- Open your base layout, e.g.
src/layouts/Layout.astro. - Paste the snippet inside
<head>withis:inlineso Astro leaves it as is. - View transitions are tracked as pageviews.
<script is:inline 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 Astro?
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 Astro 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 Astro site, so you can compare the numbers before you switch.
How do I see visitors from ChatGPT on my Astro 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.