Skip to content
Coming soon: a Shopify app and a WordPress plugin. One-click install, same monitoring.Tell us which one you need
TagEasy

Documentation

Setup, platform installs, monitoring, and the API. Written to be followed, not skimmed.

Install on WooCommerce

WooCommerce runs on top of WordPress. The recommended install uses GTM4WP — the industry-standard plugin that handles GTM injection AND auto-pushes WooCommerce dataLayer events.

Step 1 — Install GTM4WP

In WordPress Admin → Plugins → Add New, search for GTM4WP (by Thomas Geiger, 200k+ active installs). Install + Activate.

Plugin URL: wordpress.org/plugins/duracelltomi-google-tag-manager

Step 2 — Paste your GTM container ID

  1. WordPress Admin → Settings → Google Tag Manager → General
  2. Paste your GTM-XXXXXXX container ID into Google Tag Manager ID
  3. Set Container code on/off to Enabled
  4. Save

Step 3 — Enable WooCommerce integration

This is the key step that makes WooCommerce events fire automatically.

  1. Same settings page → Integration tab
  2. Find the WooCommerce section and enable:
    • Track classic e-commerce
    • Track enhanced e-commerce
    • Track product impressions
    • Track product clicks
    • Add to cart through AJAX
    • Purchase confirmation page event
  3. Save

GTM4WP now pushes GA4-compatible ecommerce events (view_item, add_to_cart, begin_checkout, purchase) to the dataLayer on every relevant page. TagEasy's WooCommerce event templates listen for these exact event names.

Step 4 — Verify in GTM Preview

  1. In GTM, click Preview
  2. Open your store, browse to a product page — GTM's debug panel should show a view_item dataLayer push
  3. Add it to cart — add_to_cart
  4. Proceed to checkout — begin_checkout
  5. Complete a test purchase (use Stripe test mode if you've enabled it on WooCommerce) — purchase with the order's transaction_id + value

Pre-built event templates for WooCommerce

  • woocommerce:ga4:view_item
  • woocommerce:ga4:add_to_cart
  • woocommerce:ga4:begin_checkout
  • woocommerce:ga4:purchase

All flagged with installNote: gtm4wp_recommended — the TagEasy wizard surfaces a callout reminding you to install GTM4WP for these to fire.

Alternative — manual install without GTM4WP

If you can't install the plugin, follow the WordPress install for the base GTM snippet, then write your own dataLayer.push() calls in WooCommerce hooks (woocommerce_after_single_product, woocommerce_add_to_cart, etc.). This is much more work — most users go GTM4WP.

Common gotchas

  • Other WooCommerce GA plugins — disable any other GA-for-WooCommerce plugin (Google for WooCommerce, MonsterInsights eCommerce, etc.). They'll double-fire events.
  • Caching — clear WP cache after enabling GTM4WP's WooCommerce integration.
  • High-Performance Order Storage (HPOS) — GTM4WP is HPOS-compatible. No special steps.