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 from GTM Kit, General, Run setup wizard or directly at wp-admin/admin.php?page=gtmkit_setup_wizard.
What the wizard does
The wizard is a guided alternative to filling in the General and Integrations tabs by hand. It validates your container ID, sets sensible defaults, and lets you toggle integrations for plugins you already have installed (WooCommerce, Easy Digital Downloads, Contact Form 7).
You can skip any step and configure it manually later. Nothing the wizard does is irreversible.
Steps
1. Welcome screen
On first activation, GTM Kit redirects you to the wizard. Click Get started.
2. Enter your GTM container ID
Paste your container ID. The field auto-prefixes GTM- and uppercases as you type, so k8vhx becomes GTM-K8VHX. If you do not know your ID, see Find your GTM container ID.
The validation indicator turns green when the ID matches the GTM-XXXXXXX pattern.
3. Choose tracking preferences
The wizard asks which broad areas you want GTM Kit to handle: Page Type, Track WooCommerce and Track Contact Form 7.
4. Pick integrations
The wizard detects which compatible plugins are active and offers to enable matching integrations:
- 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. - Easy Digital Downloads — view_item, add_to_cart, begin_checkout, purchase.
- Contact Form 7 — form submission events.
Plugins you do not have installed are not offered.
5. Verify and finish
The final step shows a preview of your data layer with the configured options. Click Finish to leave the wizard. You can come back to GTM Kit, General or GTM Kit, Integrations to fine-tune anything.
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.