Fathom Not Tracking Page Changes in Next.js and SPAs

How to fix it

Try these in order — the most common fix is first.

1. 1. Plain script: enable SPA mode

   Copy steps
   1. Add data-spa="auto" to the Fathom script tag (uses the History API, falls back to hash changes)
   2. Use data-spa="history" or "hash" if you only use one routing type
   3. Reload and click through a few routes while watching the real-time dashboard
   Did this fix it? Yes No

2. 2. Next.js App Router: use fathom-client

   Copy steps
   1. Run npm install fathom-client
   2. Create a client component ('use client') that calls load('SITE-ID', { auto: false }) once in useEffect
   3. In a second useEffect that depends on usePathname() and useSearchParams(), call trackPageview
   4. Wrap it in <Suspense fallback={null}> and render it inside <body> in app/layout.tsx
   Did this fix it? Yes No

3. 3. Remove double tracking

   Copy steps
   1. If you call trackPageview manually, make sure auto is false (or data-auto="false")
   2. Don't combine data-spa with manual route-change tracking
   Did this fix it? Yes No

Symptoms

Only landing pages are recorded, pageviews are far lower than expected, or every pageview is counted twice.

Why it happens

• Script loaded without SPA mode, so history changes aren't tracked
• Next.js App Router component missing 'use client', Suspense, or the pathname dependency
• Both automatic and manual pageview tracking enabled (double counts)
• Framework navigation (e.g. Livewire wire:navigate) not firing a pageview

This guide also covers

• fathom next.js not tracking
• fathom analytics spa
• fathom-client app router
• fathom pageviews not tracking route change

Other Fathom Analytics errors

• Fathom Analytics Not Working (No Visits Showing)
• Fathom Only Showing Homepage in Stats
• Fathom Analytics Blocked by Ad Blockers
• Fathom Events Not Showing Up
• Fathom WordPress Plugin Not Tracking
• Fathom Numbers Different From Google Analytics
• Fathom Referrers Missing or Showing as Direct
• Fathom Google Search Console Data Not Showing