How to Use GTM Preview Mode Like a Pro (Debugging Walkthrough)

What GTM Preview Mode Is For

GTM Preview Mode lets you test changes to your Google Tag Manager container before they go live. It shows exactly which tags fired on each user interaction, which triggers evaluated, which variables were active, and what values they contained — all in real time as you browse your site.

It is the first tool to reach for when a tag is not firing, when a conversion is not tracking, or when you need to verify a new configuration before publishing.

Starting a Preview Session

1. In GTM, click the Preview button (top right of the container workspace)
2. In the Connect Tag Assistant window, enter your website URL
3. Click Connect — your website opens in a new browser tab with GTM debug mode active
4. The Tag Assistant panel appears at the bottom of your website

Note: Preview mode is tied to your browser and a session token. It only works in the browser where you clicked Preview. Other browsers or devices will not see the debug panel.

Reading the Summary View

The left panel shows a list of all events that occurred on the current page load, in chronological order. Common events you will see:

• Container Loaded: the GTM container code executed
• Initialization: pre-existing data layer events were processed
• Page View: a page view trigger was evaluated
• DOM Ready: the page DOM finished loading
• Window Loaded: all page resources loaded
• Custom events: any events pushed to the data layer by your site (e.g. "purchase", "form_submitted")

Click any event in the list to see what happened during that event.

Checking Which Tags Fired

When you click an event, the right panel shows two tabs:

• Tags tab: shows all tags that fired during this event (green = fired, red = not fired/blocked)
• Triggers tab: shows which triggers evaluated during the event and whether they passed or failed

If a tag appears under "Tags Fired" — it fired successfully. If it appears under "Tags Not Fired" — a trigger blocked it or no trigger matched. Click the tag name to see its specific configuration and which trigger was active.

Reading Variable Values

Click any event, then select the Variables tab. You will see all currently active variables and their values at that moment in the page lifecycle. This is invaluable for debugging:

• Is your DLV - Transaction Value returning the correct number?
• Is your Page URL variable showing the full URL including query string?
• Is your data layer User Data variable returning the email address from the form?

Debugging a Tag That Is Not Firing

When a tag is not firing (it appears in "Tags Not Fired"), the most common causes are:

1. Trigger condition not met: click the Triggers tab and find your trigger in the "Triggers That Did Not Fire" section. It will show which condition failed. Example: "Page URL does not contain /thank-you — current URL is /thankyou".
2. Wrong event timing: a Page View trigger won't catch a custom event. Make sure the trigger type matches the event type.
3. Tag blocked by exception: check if an exception trigger is preventing the tag from firing.
4. Consent blocking: if Consent Mode is active, the tag may be blocked because the required consent type was denied.

Debugging the Data Layer

Click on any custom event in the event list and select the Data Layer tab. You will see the full data layer state at that point, including all previously pushed objects and the current event's push. This helps verify that your site is pushing the correct data structure before GTM reads from it.

Summary

GTM Preview Mode gives you complete visibility into tag firing, trigger evaluation, and variable values — all before publishing changes to production. Use it every time before publishing a container version.

See our Google Tag Manager Setup and Audit service for expert GTM management.

Having trouble debugging a GTM tag? Contact Adslytics.