Cookieless web analytics for static sites

Why use Noralytic with static sites and HTML

Static sites are about speed and simplicity, and Noralytic keeps both. There is no server code, no cookies and no consent tooling to add.

It works for documentation, portfolios and blogs hosted anywhere, including GitHub Pages, Netlify and Cloudflare Pages.

• No cookies, no local storage and no stored IP addresses, so analytics alone does not need a consent banner.
• A tracking script under 1 KB that will not slow down your pages.
• Real-time stats, top pages, sources, countries, devices, campaigns and events in one simple dashboard.
• Single-page navigation is tracked automatically, because the script follows the browser history.

What you need

• A free Noralytic account with your website added under its exact domain.
• Access to the template or HTML file that contains the <head> of your pages.

How to add Noralytic to static sites and HTML

The tracking code is one line. The steps below show where it goes.

<script data-host="https://noralytic.com" src="https://noralytic.com/js/script.js" id="ZwSg9rf6GA" async defer></script>

1. 1
   Plain HTML
   Paste the snippet inside the <head> of every page, or into your shared header include.
2. 2
   Hugo
   Add it to layouts/partials/head.html, or to baseof.html.
3. 3
   Jekyll and Eleventy
   Add it to _includes/head.html (Jekyll) or your base layout (Eleventy).
4. 4
   Rebuild and deploy
   Rebuild your site, deploy it and check the real-time view.

Check that tracking works

1. 1
   Open your website
   Use a private browser window so extensions and your login do not interfere.
2. 2
   Open the Noralytic real-time view
   In your Noralytic dashboard, open your website and go to Realtime.
3. 3
   Look for your visit
   Your page view should appear within a few seconds. Click through a few pages to see each one counted.

Track custom events on static sites and HTML

Use a small script near the end of the page to track clicks on key elements.

<script>
  document.querySelector('#download')?.addEventListener('click', function () {
    window.pa && pa.track({ name: 'download' });
  });
</script>

Events appear in your Events report. A value and a unit are optional, for example pa.track({ name: 'purchase', value: 49.9, unit: 'EUR' }).

Exclude your own visits and bots

To keep your numbers clean, open your website settings in Noralytic and add your own IP address under excluded IP addresses. Make sure bot filtering is enabled so known crawlers are ignored.

Troubleshooting

• Every page needs the snippet: put it in a shared template so no page is missed.
• Hosting cache: after deploying, hard refresh or purge your CDN cache before testing.
• No data after a few minutes? Confirm that the domain in Noralytic matches your website exactly, and that the script appears in the page source.
• Ad blockers: some blockers hide analytics scripts. Test in a private window without extensions.
• Content Security Policy: if you use one, allow noralytic.com as a script and connection source.