This guide walks you through the GTM Kit setup wizard. The wizard runs automatically the first time you activate the plugin. You can also reach it later directly at wp-admin/admin.php?page=gtmkit_setup_wizard.
What the wizard does
The wizard is a guided alternative to configuring GTM Kit from the settings screen by hand. It registers your container ID, sets sensible defaults, and lets you switch on integrations for the plugins you already have installed (WooCommerce, Easy Digital Downloads, Contact Form 7).
Every choice the wizard makes is an ordinary setting you can change afterwards. Nothing it does is irreversible.
Steps
The wizard runs six screens in this order: Welcome, Essential Settings, Share Anonymous Data, Automatic Updates, GTM Kit Premium, and Getting Started. The Premium step appears on free installs only.
1. Welcome and container ID
On first activation, GTM Kit redirects you to the wizard. The Welcome screen is where you register your Google Tag Manager container.
Paste your container ID into the Container ID field. When you leave the field, GTM Kit normalises what you typed: it uppercases the value and adds the GTM- prefix if you left it out, so k8vhx becomes GTM-K8VHX. Save and continue stays disabled until the value is a valid container ID, so the button turning active is your confirmation that the ID is well formed. If you do not know your ID, see Find your GTM container ID, or use the Need help? panel beside the field, which links straight to Google Tag Manager.
On a brand-new install, if GTM Kit finds settings from another tag manager plugin already in your database, this screen first offers to import them. Pick the plugin to import from, or skip the offer to register your container ID by hand.
2. Essential Settings
This screen combines the basic data layer choice with your integrations:
- Page type: whether the page type (page, product, category, cart, checkout and so on) is included in the data layer.
- Track WooCommerce: full GA4 e-commerce events on the free plugin (view_item_list, view_item, add_to_cart, view_cart, remove_from_cart, begin_checkout, add_shipping_info, add_payment_info, purchase). Premium-only events (
add_to_wishlist,refund,order_paid) require the Woo Add-On or GTM Kit Premium. - Track Contact Form 7: form submission events.
- Track Easy Digital Downloads: view_item, add_to_cart, begin_checkout, purchase.
Each integration toggle appears only when that plugin is active on your site. Plugins you do not have installed are not offered.
3. Share Anonymous Data
An opt-in that helps GTM Kit test against the configurations people actually run. The screen lists exactly what would be sent, filled in with your own values, so you can read the real payload before deciding. The default is no, and you can change it later in the settings.
This is separate from sharing system data with support, which only ever happens when you start it from the Support page. See Sharing system data with support.
4. Automatic Updates
Choose whether WordPress should update GTM Kit automatically. This sets the same auto-update state you can toggle from the Plugins screen.
5. GTM Kit Premium
If you run the free plugin, the wizard shows one short step introducing GTM Kit Premium, worded for your site: order tracking for WooCommerce stores, consent handling for sites in the EU and EEA, or a general overview otherwise. The step is informational; one click continues past it. If GTM Kit Woo or GTM Kit Premium is active, the step does not appear.
6. Getting Started
The closing screen confirms your container is sending data and points you at the next thing to do: the GTM Templates section, which has container import files with the tags, triggers and variables for Google Analytics 4, and the tutorials. Go to the dashboard leaves the wizard.
Verify it worked
Open your public site and view the page source. You should see your GTM container script near the top. Open the browser DevTools console and type:
window.dataLayerYou should see an array of one or more event objects. See Verify GTM is firing on your site for the full smoke test.
I want to re-run the wizard
The wizard does not store a “completed” flag separate from your settings. To re-run it, navigate to wp-admin/admin.php?page=gtmkit_setup_wizard directly. Your existing settings act as the wizard’s defaults, so you will not lose configuration.
Common issues
The wizard never appears after activation. GTM Kit only auto-redirects on single-site activations and only when the activation transient is set. Multisite, bulk plugin activations, and AJAX or CLI activations all skip the redirect. Open the wizard manually instead.
You activated the plugin a long time ago and never ran the wizard. Same answer. Open it manually at the URL above. Existing config is preserved.
Save and continue stays greyed out on the Welcome screen. The container ID is not yet valid. It must be GTM- followed by letters and digits; check for a stray space or a pasted URL rather than the ID itself.