---
title: "Run the setup wizard"
date: 2026-05-04
author: "GTM Kit"
---

# Run the setup wizard

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](https://gtmkit.com/documentation/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.dataLayer
```

You should see an array of one or more event objects. See [Verify GTM is firing on your site](https://gtmkit.com/documentation/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.

## Related articles

- [Install and activate GTM Kit](https://gtmkit.com/documentation/install-and-activate-gtm-kit/)
- [Find your GTM container ID](https://gtmkit.com/documentation/find-your-gtm-container-id/)
- [Verify GTM is firing on your site](https://gtmkit.com/documentation/verify-gtm-is-firing-on-your-site/)