Set up GTM4WP features

Google Tag Manager for WordPress adds a Google Tag Manager container to every page of your site and fills its data layer with the WordPress, visitor and store data you choose. The guides in this section explain how to set up each feature, starting with the container itself.

This page describes GTM4WP 2.1.0.

Where the settings are

In the WordPress admin, open Settings, then Google Tag Manager. The settings screen lists its sections in a sidebar; click one to open it. The Search settings box above the list narrows the sidebar to the sections whose name, option labels or option descriptions contain the text you type.

The WooCommerce and Easy Digital Downloads sections stay greyed out until a supported version of that plugin is active on the site.

The Export settings and Import settings buttons move your configuration between sites, for example from a staging copy to the live site. An import replaces every setting with the values in the file. Google service account keys are not part of the file, so add them again on the other site.

Only administrators see the settings screen by default. A developer can give it to another role with the gtm4wp_admin_page_capability filter, described on the actions and filters page.

Where to start

1. Add your container. Open the Google Tag Manager container section and enter your container ID in the Google Tag Manager containers table. Until a container is set, GTM4WP writes no container code into your pages. The container settings reference describes every option of this section.
2. Decide whose visits you do not want to track. The User roles to exclude option in the same section keeps the container off the pages for logged in users with the roles you select, as the guide to excluding admin users explains.
3. If your visitors have to agree to tracking, set up consent mode and your consent tool before you collect data, and read the GDPR page.
4. Switch on the data layer variables your tags need, and the events you want to track: user events, media players or Contact Form 7 submissions.
5. If you run an online store, set up ecommerce tracking for WooCommerce or Easy Digital Downloads.
6. Check the result. The GTM4WP section of WordPress Site Health shows what is switched on and runs status tests on the configuration.

All setup guides