// 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
Share

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

  1. FIX 1Publish the container version

    1. 01In GTM click Submit and Publish the version containing the Hotjar tag
    2. 02Wait a few minutes before verifying
    Did this fix it?
  2. FIX 2Check the network requests

    1. 01Open developer tools > Network and reload
    2. 02Look for a gtm.js request with your GTM ID
    3. 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?
  3. FIX 3Use GTM Preview mode

    1. 01Click Preview in GTM and open your site
    2. 02Confirm the Hotjar tag shows as Fired on the page
    3. 03Set the trigger to All Pages (or Consent Initialization / your consent trigger if you gate it)
    Did this fix it?
  4. FIX 4Re-run Verify installation

    1. 01In Hotjar open Sites & Organizations and use the Verify installation tab
    2. 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 us

Watch Hotjar Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Hotjar errors

All 15 Hotjar errors and fixes →