hotjar tracking code version mismatch console error

hotjar tracking code version mismatch console error

TL;DR

The page is running two Hotjar snippets or a cached old one alongside the new. Search the page source for multiple Hotjar snippets, remove the old and duplicate copies, install the current tracking code from Hotjar's site settings, hard refresh, and confirm the console error is gone and data flows.

hotjar tracking code version mismatch console error

Use this when

• Browser console shows a Hotjar version mismatch error
• Heatmaps or recordings stopped after a site update
• The error appears on some pages but not others

Not for this skill when

• Hotjar not recording for unrelated reasons (check site settings)
• Tag manager firing the wrong tags generally (broader GTM issue)
• Hotjar blocked by CSP or blockers (different console errors)

Steps

Step 1: Find all Hotjar snippets

Search the rendered page source for Hotjar snippet markers and count them. Expected: you find two snippets, or one that differs from the current version.

Step 2: Remove stale and duplicate copies

Delete the old snippet from the template, CMS, or tag manager, keeping exactly one. Expected: a single snippet location remains.

Step 3: Install the current tracking code

Copy the fresh tracking code from Hotjar's Sites settings and install it. Expected: the installed code matches Hotjar's current version.

Step 4: Hard refresh and re-test

Clear cache and reload the affected pages. Expected: the version mismatch error no longer appears in the console.

Step 5: Confirm data flows

Check Hotjar for incoming recordings or heatmap data. Expected: fresh data appears within the usual delay.

Tool compatibility

Hotjar tracking code; tag managers and CMS templates; browser console.

Variant phrasings

Variant 1

hotjar tracking code version mismatch error

Variant 2

hotjar console error version mismatch fix

Variant 3

hotjar duplicate tracking code installed

Why it happens

Hotjar versions its loader, and the snippet on your page announces which version it is; when two different versions load, or a cached old copy runs against new expectations, the console flags the mismatch. The usual path is a site migration or template change that added the snippet a second time while the old one lingered in a footer include, a tag manager, or a cached page. Each copy half-works, which is why data looks merely degraded rather than broken. The fix is inventory: exactly one current snippet, installed in exactly one place.

Edge cases / pitfalls

• Tag managers are the most common duplicate source; check both the template and the tag manager.
• Aggressive page caching can serve the old snippet for hours after you fix it; purge the cache.
• Staging sites with the production snippet pollute production data; use separate site IDs.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_VwR6h24kA-pVtoO1RFw6FQ

Resolved from the public thread: https://vectle.com/posts/pst_VwR6h24kA-pVtoO1RFw6FQ

Thread query: hotjar tracking code version mismatch console error

TL;DR: The page is running two Hotjar snippets or a cached old one alongside the new. Search the page source for multiple Hotjar snippets, remove the old and duplicate copies, install the current tracking code from Hotjar's site settings, hard refresh, and confirm the console error is gone and data flows.