// troubleshooting guide · hotjar
Hotjar Not Working With Google Tag Manager
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 22, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · hotjar/gtm-installation-not-working4 FIXES
// quick answer
Hotjar installed through Google Tag Manager usually fails because the container version was never published, the tag trigger does not fire, or the SPA state-change trigger conflicts with Hotjar. Check the network tab, then publish and re-verify.
Most likely fix: Publish the container version
How to fix it
// try these in order, the most common fix is first
FIX 1Publish the container version
- 01In GTM click Submit and Publish the version containing the Hotjar tag
- 02Wait a few minutes before verifying
Did this fix it?FIX 2Check the network requests
- 01Open developer tools > Network and reload
- 02Look for a gtm.js request with your GTM ID
- 03Look for a script with hotjar- plus your Site ID; if GTM loads but Hotjar does not, the trigger is wrong
Did this fix it?FIX 3Use GTM Preview mode
- 01Click Preview in GTM and open your site
- 02Confirm the Hotjar tag shows as Fired on the page
- 03Set the trigger to All Pages (or Consent Initialization / your consent trigger if you gate it)
Did this fix it?FIX 4Re-run Verify installation
- 01In Hotjar open Sites & Organizations and use the Verify installation tab
- 02If the tag fires but verification still fails, contact support
Did this fix it?
SANDBOX · hotjar RUNS IN YOUR BROWSER
Try it: see where visitors click and scroll, then replay their sessions
A hands-on Hotjar-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Verify installation fails, or no recordings appear, although the Hotjar tag exists in GTM.
Why it happens
- C-01GTM container changes saved but not published
- C-02Tag trigger not firing on the affected pages
- C-03Tag type conflicting with Hotjar's single-page-app change detection
- C-04Consent mode or consent tools blocking the tag
- C-05GTM itself blocked by an ad blocker or CSP
// this guide also covers
- hotjar google tag manager not working
- hotjar gtm not firing
- hotjar verify installation gtm
Still not working?
If Hotjar keeps failing, you're not alone. See every Hotjar problem users report or the alternatives people switch to.
Done fighting Hotjar? Our small team builds your own Hotjar alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usOther Hotjar errors
- Hotjar Not Recording Sessions
- Hotjar Tracking Code Not Installed or No Data Received
- Hotjar Heatmap Not Showing Data
- Hotjar Recordings Blank or Missing CSS
- Hotjar Survey Not Showing on Site
- Hotjar Content Security Policy (CSP) Errors
- Hotjar Heatmap Screenshot Wrong or Cut Off
- Hotjar Not Tracking Single Page App Page Changes