Install guides / Static sites & docs

Add PageLens analytics to Docusaurus

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 Docusaurus takes about two minutes.

Steps

  1. Open docusaurus.config.js.
  2. Add the script to the scripts array.
  3. Doc navigation is tracked automatically.
export default {
  // ...
  scripts: [
    { src: 'https://app.pagelens.io/script.js', defer: true, 'data-site-id': 'YOUR_SITE_ID' },
  ],
};

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.

Don't have a site ID yet?

Create a free PageLens account: 7-day trial, no card, no cookie banner needed.

Start free trial

Questions

Do I need a cookie banner for analytics on Docusaurus?

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 Docusaurus 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 Docusaurus site, so you can compare the numbers before you switch.

How do I see visitors from ChatGPT on my Docusaurus 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.

Other static sites & docs

HugoJekyllEleventy (11ty)VitePressMkDocs (Material)