GTM tags & variables

Beyond the auto-generated GA4 Event tag that every TagEasy event produces, you can create + manage arbitrary GTM tags and variables directly from the Events tab on any site detail page. TagEasy pushes them into your container's dedicated TagEasy workspace alongside the generated tags — review and publish from the same Publish button.

Where to find it

From any site detail page, open the Events tab. Two panels live near the top:

  • GTM tags — list, create, edit, clone, delete, bulk-toggle draft state, push to workspace
  • GTM variables — Constants + JavaScript variables you can reference from any tag field with {{name}}

Tag types

Seven types are supported in v1, picked from a 2-column grid when you click + New tag:

  • GA4 Configuration (Google tag) — loads gtag.js + initialises a measurement ID. Usually fires on All Pages.
  • GA4 Event — sends a single GA4 event. Needs a Config tag on the same property to fire (see auto-create below).
  • Google Ads Conversion — pair with your AW-… conversion ID and label from Google Ads.
  • Meta Pixel — base — initialises the Meta Pixel and fires PageView. Add once per site.
  • Meta Pixel — event — fires a Meta Pixel event (Purchase / Lead / etc.). Requires the base pixel to load first.
  • TikTok Pixel — loads the TikTok pixel + (optionally) a single tracked event.
  • Custom HTML — arbitrary <script> / <html>. Escape hatch for anything not covered above.

GA4 Config auto-create

GA4 Event tags only fire when a GA4 Configuration tag has loaded gtag.js on the page. If you create a GA4 Event tag but have no Config tag, TagEasy auto-creates one named GA4 Config (G-XXXXXX) using your site's measurement ID, set to fire on All Pages. The created tag is a normal Tag row you can rename, edit, or delete from the GTM tags panel.

Triggers (multi-fire + blocking)

Every tag picks one of two firing modes:

  • Fire on every page (All Pages) — synthesises a managed pageview trigger in your workspace. Used by Config tags and base pixels by default.
  • Fire on specific events — multi-select from this site's VisualEvents. The tag fires whenever ANY selected event matches.

A collapsible Blocking triggers section accepts any number of additional VisualEvents. If any blocking trigger matches on a page, the tag won't fire — useful for opt-out scenarios.

Drafts

Toggle Save as draft in the tag form to store + edit a tag locally without pushing it to the GTM workspace. Drafts show an amber badge in the list and are skipped by the sync entirely. Flip the toggle off when you're ready to ship.

Variables

Below the GTM tags panel, the GTM variables panel manages reusable values:

  • Constant — a literal string. Set once, reference everywhere as {{Name}}.
  • JavaScript — a function expression that runs in the page context and returns a value. Use for derived values you can't compute statically.

Type {{ in any value-bearing tag field (event parameters, Google Ads value / transaction ID, Meta custom data, TikTok event properties) and an autocomplete dropdown lists your variables. Arrow keys + Enter to insert.

Auto-detected dataLayer variables continue to flow through the existing DataLayer variable creator — they live in a separate flow and don't show up here.

Push to GTM workspace

Two ways to sync your tags into the GTM workspace:

  • Push to GTM workspace button on the tags panel — one-click sync, idempotent. Returns warnings if anything looks off (e.g. missing GA4 Config on event tags).
  • Auto-push toggle — per-site setting in the GTM tags panel. When on, every tag or variable change syncs to the workspace in the background. The workspace → live container publish step stays manual.

The Publish-to-GTM panel above the tags list handles the final workspace → live publish. Use the Sync TagEasy & publish button there to do both steps in one click.

Bulk + clone

Both panels have multi-select checkboxes + bulk actions:

  • Events list: bulk Pause / Resume / Delete.
  • Tags list: bulk Move to draft / Mark ready / Delete.
  • Tags + variables: per-row Clone button (copy icon between Edit and Delete) saves a duplicate as a draft with a (copy) suffix.

Activity log

Every tag and variable CRUD action — create, edit, clone, delete — is logged to the per-site Settings → Activity feed. Useful for “who changed this tag last Tuesday?” investigations.

Cleanup behavior

A few things worth knowing about how TagEasy keeps your GTM workspace tidy:

  • Deleting a tag in TagEasy also deletes the corresponding GTM resource on a best-effort basis. If the GTM call fails (network, scope, container disconnected), the local row is still deleted — manually clean up in GTM if needed.
  • Renaming a tag in TagEasy renames the GTM resource by id, not by old name — no orphans.
  • The synthetic te:all-pages trigger is auto-deleted when no Tag uses All Pages mode anymore.