Tag Assistant is a troubleshooting tool that helps you verify the implementation and functionality of tags on your website. It lets you review the tags, events, and data on your website, export and import debug sessions, and share a debugging URL so others can debug for you.
When your website contains the Google tag, Tag Assistant adds tagged and untagged pages to the Tag coverage summary, so you have an overview of the overall tagging status of your site.
Before you begin
We recommend you install the Tag Assistant Companion Chrome extension to enable these features:
- Detection of the Google tag inside an iframe.
- Debugging of pop-up windows or new tabs opened from the current window.
- The debug window opens in a new browser tab instead of a pop-up. This allows the user to manipulate the browser URL bar and can help facilitate debugging of referrer-based actions.
- Multiple windows can be debugged in the same debug session. Each window is marked with a symbol in the event tree so that they can be easily identified.
Connect Tag Assistant to your website
- Go to tagassistant.google.com.
- Click Add domain.
- Enter the URL of the website you want to debug, starting with "https://" or "http://".
- Click Connect.
When you connect Tag Assistant to your website, we add a debug parameter (_dbg) to the end of your URL. The parameter helps you view events in other debugging surfaces, such as Google Analytics' DebugView.
Disconnect Tag Assistant
- Open the web browser tab that is active for debug mode.
- In the debug window, click Stop Debugging or the X in the upper left corner.
What's next?
To resume an active or closed debug session, click the domain name from the Active Domains or History on the Tag Assistant homepage.
Debug information is not visible to your regular website visitors. The debug window will stay open and display debug information while you navigate within the same domain and as long as there is the Google tag on the page.
As you click through your website, we'll update Tag Assistant with information about your tags.
Fix connection issues
If the debug window does not connect to your page successfully, try some of these solutions:
- The URL you entered might not have the Google tag on the page. Try a different URL on your website where you expect to have the Google tag installed.
- The debug parameter added to the page URL may interfere with page behavior. To solve this, edit the domain that you enter for debug mode, and deselect Include debug signal in the URL.
- The Google tag script is loaded after the point when Tag Assistant tries to connect to the page. Click Retry to connect again.
- Your page is an AMP page. AMP is not currently supported by Tag Assistant.
- The page loads the Google tag in an iframe. iframe-loaded tag configurations can only be debugged when the Tag Assistant Companion chrome extension is also installed.
- Multiple browser redirects can prevent the debug window from loading.
- Ad blockers installed in your web browser may prevent the Google tag from running. Disable ad blockers for the pages you need to test.
- If you have the Tag Assistant Companion installed, make sure the extension has permission to read and change site data for the pages you need to test.
- Consent management tools may block Google tags. Configure any consent management tools that you use to allow interaction with Google's consent API.