Troubleshooting

GTM Preview Not Working? 6 Fixes That Actually Connect

GTM Preview Not Working? 6 Fixes That Actually ConnectTag Assistant — debug checklistContainer published?Trigger conditions met?Variable has a value?Blocked by an exception?Consent granted?Tag did not fire0 of 1 triggers matched

GTM Preview won't connect, the Tag Assistant tab spins, or your page opens but Preview never links up. It's almost always one of a few environment issues, not a broken container. Here are the fixes in the order worth trying them.

1. Disable ad/tracking blockers (the #1 cause)

Ad blockers, privacy extensions and strict browser shields block the very domains Preview needs (googletagmanager.com, tagassistant.google.com). This is the most common reason Preview won't connect.

  • Test in a clean profile or incognito with extensions disabled.
  • Turn off content blockers and strict tracking protection for the site.
  • Some VPNs and corporate proxies block the same domains, try off-network.

2. Allow third-party cookies for the Tag Assistant connection

Tag Assistant uses cookies/storage to hold the debug connection. If third-party cookies are fully blocked, the connection drops. Allow them (at least for google.com / tagassistant.google.com) while debugging, then re-tighten after.

3. Confirm the container is actually installed

  1. View source / Network and confirm gtm.js?id=GTM-XXXXXXX loads on the page.
  2. Check the ID matches the container you clicked Preview from, wrong container = no connection.
  3. If you just installed it, hard-refresh; a cached page without the snippet won't connect.

Embedded pages

Connecting Preview to a page that's embedded in another app needs the Tag Assistant Companion extension. Opened top-level (a normal tab), it connects with no extension.

4. Let the new tab open

Preview launches your page in a new tab and appends a debug parameter. A pop-up blocker that swallows that tab looks exactly like "Preview not working." Allow pop-ups for tagmanager.google.com and try Connect again.

Practice this on a real container

Once Preview connects, the real skill is reading it. Practice triggers and exceptions on a live container so you can tell a connection problem from a genuinely non-firing tag.

Practice debugging in Preview →

5. Check HTTPS, CSP and the URL

  • HTTPS mismatch. Preview a secure URL; mixed http/https can break the connection.
  • Content Security Policy. A strict CSP can block the GTM loader or the Tag Assistant connection, allow the required Google domains.
  • Exact URL. Paste the precise page URL you want to debug, including the path.

It connects, but live behaves differently

If Preview works but the live site doesn't track, that's not a Preview bug, it's an unpublished change. Preview runs your latest workspace draft; production runs the last published version. Submit → Publish, then hard-refresh.

Now go practice it

Reading sticks when you do it. These hands-on lessons load your own GTM container and let you debug in Tag Assistant.

Frequently asked questions

Why is GTM Preview not connecting?

Most often an ad blocker, privacy extension or strict browser shield is blocking the domains Preview needs (googletagmanager.com, tagassistant.google.com). Test in a clean or incognito profile with extensions disabled, allow third-party cookies, and make sure pop-ups are allowed so the debug tab can open.

Why does Tag Assistant keep spinning or fail to connect?

Common causes are blocked third-party cookies, a content blocker stopping the connection, a pop-up blocker swallowing the debug tab, or a strict Content Security Policy blocking the GTM loader. Also confirm the gtm.js snippet is actually on the page and its ID matches the container you previewed from.

GTM Preview works but the live site doesn't track. Why?

That's not a Preview problem, it's an unpublished change. Preview runs your latest workspace draft, while the live site runs the last published version. Click Submit → Publish, then hard-refresh the live page.

Do I need an extension for GTM Preview?

Not for normal top-level pages, Preview connects without one. You only need the Tag Assistant Companion Chrome extension when the page you're debugging is embedded inside another app (in an iframe).

Related posts

About the author

Nathan Gage
Nathan Gage

Analytics & Tag Management Consultant

Nathan Gage got his start in marketing through Google Tag Manager. Seeing how tracking customer behavior could turn raw clicks into insight you can actually act on is what pulled him into the field. Since then he has worked both full time and as a consultant with 15 marketing agencies, supporting brands that spend anywhere from a thousand dollars a month to over a million. Along the way he built a multi-touch attribution app, and he created The Happy Tagger so anyone can practice GTM, GA4 and server-side tracking on a real container instead of a production site.