From 396aa01570486a321e263d2a6012b5fbd8e84576 Mon Sep 17 00:00:00 2001 From: gonsolvis-mxp Date: Tue, 12 May 2026 12:36:46 +0200 Subject: [PATCH] Update google-tag-manager.mdx https://github.com/mixpanel/mixpanel-gtm-template/blob/d8a61349668b8cd00721e3e1fc6954ac82aec9b6/metadata.yaml#L9 --- .../integrations/google-tag-manager.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/pages/docs/tracking-methods/integrations/google-tag-manager.mdx b/pages/docs/tracking-methods/integrations/google-tag-manager.mdx index 1936bcb65d..214a226eea 100644 --- a/pages/docs/tracking-methods/integrations/google-tag-manager.mdx +++ b/pages/docs/tracking-methods/integrations/google-tag-manager.mdx @@ -171,6 +171,17 @@ The more complex tag types (`group`, `people`, and `track`) are elevated to the Once you select a tag type, **additional options may appear.** Please have a look at the SDK reference for details on how to configure these options. +### GTM Template Default Overrides vs. JS SDK + +As of October 2025, the GTM template sets two initialization defaults that differ from the JS SDK. This applies to anyone who installed the template fresh or opted into new versions of the template update. + +| Option | GTM Template Default | JS SDK Default | +|---|---|---| +| `persistence` | `localStorage` | `cookie` | +| `stop_utm_persistence` | `true` | `false` | + +Switching between template versions and/or the JS SDK without accounting for these can change how persistent user data is stored and whether UTM parameters persist across subsequent events. To override either, add them as [Custom Initialization Options](#custom-initialization-options). + ### Tag to Function Mapping **Essential Tags**