Why is Plausible or GA4 not tracking visitors?

You set up Plausible or GA4, waited a few days, and the dashboard is showing zero sessions — or a suspiciously low number that doesn't match reality. Analytics tracking failures have a few common causes, and most of them are fixable without touching your VeloCMS code.

Are you testing with an ad blocker installed?

Start by checking this before anything else. Open your blog in a browser with all extensions disabled (Chrome incognito mode with extensions disabled, or a fresh Firefox profile) and see if your analytics tool registers the visit. If it does, your own ad blocker is filtering out the tracking script during your testing — this is expected behavior. Your readers without ad blockers are being tracked correctly.

CSP headers blocking the tracker script

VeloCMS sets a strict Content Security Policy (CSP) on all pages. The default CSP allows scripts from the page's own origin plus a few explicitly permitted CDNs. If your analytics script domain isn't in the CSP allowlist, the browser will silently block it. You'll see an error in the browser console like: 'Refused to load the script because it violates the following Content Security Policy directive: script-src...'.

The CSP is set by the platform and is not editable from the admin. It already allows the built-in analytics providers (Plausible, Google Analytics and Tag Manager, Microsoft Clarity), so install them through Admin → Plugins rather than pasting a hand-written script tag. If the console still shows a violation for a script from some other domain, that domain is not on the allowlist — contact support with the exact domain named in the console error.

GA4 — real-time report lag

GA4's standard reports can have a data processing delay of up to 48 hours. Don't judge GA4 tracking by looking at the standard reports on day one. Instead, check the Realtime report in Google Analytics — it updates within seconds and is the correct way to verify if the tracking snippet is working. If you see yourself in the Realtime report when you visit your blog, GA4 is working. The standard reports will catch up.

Custom domain proxy for Plausible

If you want to reduce ad-blocker blocking, you can proxy the Plausible script through your own domain using Cloudflare Workers. The setup involves creating a Cloudflare Worker that forwards requests to plausible.io and serving the Plausible script from analytics.yourdomain.com/js/script.js instead of plausible.io/js/plausible.js. This takes about 10 minutes and significantly improves tracking completeness. See Plausible's official proxy documentation for the Cloudflare Worker script.

Script load order and timing

VeloCMS loads analytics scripts using Next.js's Script component with strategy='afterInteractive'. This means the script loads after the page is interactive — it will not block page load. If you added a custom analytics script tag directly to the theme HTML template instead of installing the provider's plugin at Admin → Plugins (Plausible, Google Analytics, Fathom, or Clarity), it may be blocking rendering. Use the plugin at Admin → Plugins to add your tracking snippet — VeloCMS handles the script loading strategy automatically.