A Guide to DebugView in Google Analytics 4

Updated: March 30th, 2025

Never trust your gut when implementing something in Google Analytics (or any other platform). Always verify that the data was received by the platform and displayed in reports as you expect it.

Luckily, GA4 has a neat feature called DebugView.

DebugView in Google Analytics 4 allows for the granular checking of incoming data (without waiting for hours). In this blog post, I will show you how to use it.

Table of Contents

Here’s what you will learn in this tutorial

• Video Tutorial
• Where can you find DebugView?
• 3 ways to enable DebugView (for websites)
  • #1. GA Debugger Chrome Extension
  • #2. GTM Preview mode
  • #3. debug_mode event parameter
• Overview of the DebugView Interface
• Using the DebugView
• What to do if DebugView is not working?
• Final Words

Where can you find DebugView in Google Analytics 4?

First, let’s start with the very basics. You can find it by going to Admin > DebugView on the left side of the GA4 interface. Click it.

That’s the place where your debugging should take place. Do not mix this with the GTM Preview and Debug mode. They are two different beasts.

Google Tag Manager Preview mode debugs tags stored in a GTM container (Universal Analytics, Google Analytics 4, Google Ads, Facebook Pixel, etc.). Google Analytics 4 DebugView is designed to view the incoming data in your GA4 property (and only that).

Once you go to the DebugView, you likely won’t see any data there (because it only displays events containing a special “debug mode” parameter). In other words, you must enable the DebugView in your GA4 event tracking to start seeing something.

In the next chapter, we’ll learn how to do that.

3 ways to enable DebugView in Google Analytics 4 (for websites)

To enable the DebugView in GA4, you have several options for websites (any of them will work):

• Enable the GA debugger Chrome extension
• Have enabled Google Tag Manager’s Preview mode on a page that you’re debugging
• Send a debug_mode parameter together with an event

If you want to learn how to enable DebugView on mobile apps, please refer to this page.

#1. GA Debugger Chrome Extension

Your first option is to install the extension here. Once you do that, then click the extension’s icon (so that you can see the ON ribbon).

From this moment, start interacting with the website, and eventually, you will see your events coming into the DebugView.

Why does this happen? When the Debugger extension is installed and activated, it checks all the requests sent to Google Analytics 4 and adds an additional parameter needed for the DebugView to display the data. That parameter is _dbg:

#2. GTM Preview mode automatically makes the data visible in the DebugView

If you have implemented GA4 with Google Tag Manager and are currently debugging the setup with Preview and Debug mode, then there is nothing else you need to do. Just like the GA Debugger Chrome extension, the GTM Preview mode adds an additional parameter that instructs Google Analytics 4 to display that incoming data (from your browser) in the Debug View.

#3. debug_mode event parameter

If you want to make the data visible in the DebugView even while the GTM Preview mode is disabled (and you don’t want to install the browser extension), you can add the debug_mode parameter to the events. To enable the parameter, add the debug_mode to the Google tag and then enter any value (but “true” without quotation marks makes the most sense).

You have two choices regarding where to include the debug_mode parameter:

• In the Google Tag (a.k.a. GA config tag). Then, all the other event tags that are using it will also inherit the parameter)
• Or only in certain GA4 event tags. In that case, the debug_mode parameter will be applied only to those tags and only those particular events will be displayed in the DebugView of Google Analytics 4

Let me show you how to do that with the Google Tag.

In Google Tag Manager, you can do that by opening the Google tag and adding the following parameter:

If the debug_mode parameter contains any value, the event will be seen in DebugView. Even if you enter the word “false”, it will still activate the debug view.

There are two ways to keep it disabled:

• Do not include the debug_mode parameter in your GA4 tags (or at least do not publish your tags live while debug_mode is in the tags)
• or set the value of debug_mode with an undefined variable. Entering the plain word “undefined” will still activate the debug view.

If you are using a hardcoded gtag.js, here are the instructions on how to include the debug_mode parameter.

And that’s it. Once you enable DebugView (by choosing one of the options above), you can go to GA4 > Admin > DebugView and see what is happening there.

Speaking of the aforementioned three methods, I always prefer the first two. They are just simpler.

Overview of the DebugView Interface

The UI of the DebugView can be split into several sections:

1. Minutes stream
2. Seconds stream
3. Top Events
4. User Properties
5. Device Selector

Here, you will see the data for the last 30 minutes.

#1. Minutes stream (on the left side of the DebugView) shows a series of circles, one circle for each of the most recent 30 minutes. The number in the circle indicates the count of events received in that minute. Clicking on one of these circles populates the Seconds stream with events that were logged during that minute of time. This allows you to examine the events logged over the last 30 minutes in greater detail.

#2. Seconds stream (middle column) is where the main action/debugging happens. Here you will see a list of events at a more granular level. Each event displays a timestamp that corresponds to the time of its logging on the development device. You can click an event to see a list of its parameters.

The Seconds stream is connected with other parts of the DebugView interface. For example, if you click a circle (with a number) in the Minutes stream, the Seconds stream will scroll down (or up) to the particular events of that minute.

#3. Top Events widget shows the top events that were logged within 30 minutes.

1. You can click on any of those events, which will work like a quick filter.
2. Once you do that, you can choose a specific parameter…
3. … and then you will see the timestamps of each parameter that was sent with that particular event in the last 30 minutes.
4. Also, you can click on a particular timestamp and then see all the parameters of that event.

It is very useful to see how (and when) the parameter values changed with that event.

#4. User Properties shows the latest state of the set of User Properties for the currently selected device. You can click the little clock icon to see how values changed in the last 30 minutes.

#5. Device Selector lets you select which particular device’s data you want to debug. The selector is located at the top left corner of the DebugView.

If multiple visitors have enabled the debug view (e.g. they all have enabled the Chrome extension), you will see multiple devices there, and it might require some time to find yourself. This especially applies to my blog, when many of my readers have enabled the GA Debugger Extension, and I have to guess which device (out of the other 10+) is mine 🙂

Using the DebugView

When you start seeing data in the DebugView, you can click on every event, and then a list of parameters will be displayed.

Click on that parameter to see the value that GA4 received.

If you are getting a lot of events, you can click anywhere on the white background of the middle column (Seconds stream), and it will pause.

Blue icons represent events, green icons represent conversions, and orange icons represent user properties.

NOTE: Sometimes, it takes longer for the data to come in.

I have noticed some delays between the event on a website and then appearing in DebugView. Sometimes, I have to wait several minutes until the events occur. That’s a bit unfortunate, and hopefully, the team behind Google Analytics 4 will improve this in the future. But right now, please be patient.

What to do if DebugView is not working?

Sometimes, it just does not work. What to do? You can check several things, and I have explained them here.

DebugView in Google Analytics 4: Final Words

Hands down, this feature is amazing. After years of using previous versions of Google Analytics, it was really annoying to wait for the e-commerce data to appear in the reports to debug it. When sending some non-event, non-pageview, and non-goal data, I always had to waste my time.

Debugging is super important, and now it has become a much quicker process for Google Analytics 4. This is a very welcome improvement in the Google Analytics space.