Title: GTM Tracking for Web Containers
Author: joshua
Published: May 21, 2024
Last modified: April 17, 2026

---

 1. [Installation resources](https://docs.parse.ly/installation-resources/)
 2. [Installation tools](https://docs.parse.ly/installation-resources/installation-tools/)
 3. [Google Tag Manager](https://docs.parse.ly/installation-resources/installation-tools/google-tag-manager/)
 4. GTM Tracking for Web Containers

#  GTM Tracking for Web Containers

This article will describe Google Tag Manager (GTM) instructions for Web Containers.
If you are using Google AMP, please see our instructions for [AMP containers](https://docs.parse.ly/gtm-tracking-for-amp-containers/).

Parse.ly provides a single tag template designed to make it easy to integrate tracking
onto your website. You can install the tracker, define custom audience segments,
configure conversion event tracking, and dynamically track page views all from within
your current GTM container.

## Prerequisites

 1. You will need to know your [Parse.ly Site ID](https://docs.parse.ly/site-id/)(s)
 2. Optional – create a [Site ID variable](https://docs.parse.ly/setting-up-a-site-id-variable/)
    to send testing data to your [sandbox](https://docs.parse.ly/sandbox/)
 3. If you’ve already added the tracking code by another means (such as [the WordPress plugin](https://docs.parse.ly/plugin-common-questions/#h-does-wp-parsely-support-google-tag-manager)),
    you should be prepared to disable that other means of tracking to avoid double 
    counting page views. Not sure? You can use our [testing instructions](https://docs.parse.ly/test-integration/)
    to see if page views are firing right now.

## Adding the template

You can find the _Parse.ly _tag template in Google’s [Community Template Gallery](https://tagmanager.google.com/gallery/#/owners/Parsely/templates/gtm-parsely-template).
To add the template to your GTM container, click the **Add to workspace** button
in the top right of the tag template page.

You can also add the tag template from within your GTM container:

 1. Navigate to the **Templates** section on the left.
 2. In the Tag Templates section, click the **Search Gallery** button.
 3. Search for “Parse.ly” and click on the tag you want to add to your container.
 4. Click the **Add to workspace** button.

## Using the template

There are three types of functionality within the _Parse.ly_ tag template:

 1. Install the [tracker](https://docs.parse.ly/tracking-code-setup/) (with [custom audience segment](https://docs.parse.ly/setting-up-audience-segments-parsely/#segments-based-on-custom-data)
    data).
 2. Fire [conversion](https://docs.parse.ly/set-up-conversion-tracking/#h-self-managed-integration)
    events.
 3. Fire [dynamic tracking](https://docs.parse.ly/dynamic-tracking/) pageviews.

You can choose the type of tag you want to use from the **Tag type** dropdown:

![](https://docs.parse.ly/wp-content/uploads/sites/5/2023/04/gtm-tag-type.jpg?w=
1024)

## _Tracker_

Use the **Tracker** tag type to add the [Parse.ly tracker](https://docs.parse.ly/tracking-code-setup/)
to your site. You can include [custom audience segment](https://docs.parse.ly/setting-up-audience-segments-parsely/#segments-based-on-custom-data)
data within this tag.

![](https://docs.parse.ly/wp-content/uploads/sites/5/2024/05/gtm-tracker-config_205ef7.
jpg?w=1024)

 1. Add your Parse.ly Site ID to the _Parse.ly Site ID_ field. (Preferably, [use your Site ID variable](https://docs.parse.ly/setting-up-a-site-id-variable/))
 2. (Optional) If you have [custom audience segment](https://docs.parse.ly/setting-up-audience-segments-parsely/#segments-based-on-custom-data)
    data you would like to provide, follow [our audience segment instructions for GTM](https://docs.parse.ly/gtm-audience-segments/).
 3. (Optional) If you don’t want to send a pageview when the Parse.ly tracker loads,
    expand the _Additional features_ section and click the _Disable autotracking_ checkbox.
    You may want to do this if your site is a single-page application and you want 
    to manually trigger pageviews with our [dynamic](https://docs.parse.ly/gtm-dynamic-tracking/)
    [ tracking](https://docs.parse.ly/dynamic-tracking/) tag instead of Parse.ly’s 
    built-in [SPA tracking](https://docs.parse.ly/single-page-application/).
 4. Click in the _Triggering_ section and select the trigger you wish to use for this
    tag. **A good rule of thumb: use the same trigger(s) you already have configured
    for Google Analytics or other trackers.** Otherwise, just choose the standard _All
    Pages_ trigger.
 5. Give the tag a descriptive name and click _Save_, and then publish your container.

The Parse.ly tracker will now deploy through Google Tag Manager on your site. You
can validate your integration using your browser’s network tab to [see the pageview events firing](https://docs.parse.ly/test-integration/?output_format=md)
and validate the [custom audience segment data in those events](https://docs.parse.ly/setting-up-audience-segments-parsely/#h-verification-and-debugging).

**Important note for customers upgrading from a previous version of the template**

You may need to manually re-enter your Parse.ly site ID and segment data in the 
Parse.ly tag before deploying the update to production.

## Next Steps

 1. Does everything work? Use our [testing instructions](https://docs.parse.ly/test-integration/)
    to verify that one, and only one, page view goes to Parse.ly with each page load.
 2. Set up your [metadata](https://docs.parse.ly/metadata/) (not available via GTM).
 3. Check to see if there’s more to set up in GTM that applies to you:
 4.  * [AMP container](https://docs.parse.ly/gtm-tracking-for-amp-containers/)
     * [Dynamic Tracking](https://docs.parse.ly/google-tag-manager/#h-dynamic-tracking)
     * [Conversions](https://docs.parse.ly/gtm-conversions/)
 5. Return to the [Integration Overview page](https://docs.parse.ly/parsely-integration/)
    to ensure you’ve completed everything

Last updated: April 17, 2026