GTM Kit Changelog

You can follow the development on our Github repository. Constributions are welcome!

Changelog

[2.11.0] – 2026-05-11

Enhancements:

“Exclude tax” toggle now controls every standard e-commerce event the data layer emits: view_cart, begin_checkout, purchase, variation prices on variable product pages (re-fired view_item + add_to_cart), and the per-item coupon discount field.

Bugfixes:

Cart, checkout, variation, and coupon-discount events now follow the “Exclude tax” toggle consistently across value, price, and discount fields. The GTM Kit Woo and GTM Kit Premium add-ons extend the fix to refund and order-paid events in their paired releases.
Silence the “translation loading triggered too early” notice that WordPress 6.7+ logs against the gtm-kit text domain by registering translations at the very start of init before any other code can request a translated string.
Close an edge case where a script-dependency notice could still appear under WordPress 6.9.1+ when a consent or CMP plugin toggled the GTM Kit container active mid-request, by asking the WordPress script registry directly which scripts were actually registered instead of re-evaluating the container gate.

Enhancements:

Heads up: GA4 numbers may move after this update. Stores with prices entered ex-tax and tax-inclusive cart display will see value change from ex-tax to inc-tax in cart and checkout events.
New gtmkit_resolve_tax_mode and gtmkit_resolve_item_discount filters let developers override the toggle programmatically (per-event or per-context) and override the per-item coupon discount calculation.
Minimum required WordPress version is now 6.8 (was 6.7). Sites still on WordPress 6.7 won’t get this update via the dashboard until they upgrade WordPress.

[2.10.0] – 2026-05-06

Enhancements:

New “CMP script attributes” section on the Consent settings page lets you toggle Cookiebot, Iubenda, and CookieYes script-blocking attributes with one click and add a custom attribute for any other CMP — no PHP filters required.
Fresh installs auto-detect a known CMP plugin (Cookiebot, Iubenda, CookieYes) and pre-select the matching toggle so the right attribute is on from day one.
New “Script gating” mode on the Consent settings page lets you choose between always loading GTM, letting it load under Consent Mode v2 control, or holding it back entirely until consent is granted. Default stays as “Always load” so existing installs see no change.
Strong-block mode masks the Google Tag Manager container until visitors consent. Works alongside any CMP and falls back gracefully when no consent signal arrives.
Power users can override which consent categories must be granted before strong-block mode unmasks GTM via the new gtmkit_strong_block_required_categories filter.
window.gtmkit.consent.state exposes the current consent state so partner scripts and integrators can inspect it without subscribing to events.
New developer hooks let CMP integrations and consent add-ons plug into GTM Kit’s consent flow without forking the plugin — sites running Cookiebot, CookieYes, WP Consent API or in-house consent solutions can now feed their state straight into GTM Kit.
Server-side broadcast gtmkit_consent_updated so other plugins can react to consent state changes without polling.
Per-event gtmkit_event_should_defer filter so future deferral features can hold individual events back when consent is missing.

Bugfixes:

Eliminate “dependencies that are not registered: gtmkit-container” warnings logged by WordPress 6.9.1+ on sites that have GTM Kit’s container active.

Other:

The Cookiebot script attribute (data-cookieconsent="ignore") is now configurable via Settings → Consent → CMP script attributes. Existing installs keep the attribute on by default to preserve current behavior; turn it off explicitly if you do not use Cookiebot.

[2.9.0] – 2026-04-29

Enhancements:

Scope Google Consent Mode defaults to specific countries or regions (e.g. DK, DE, US-CA) instead of applying them everywhere. Useful for sites with visitors both inside and outside the EU.
Consent updates from other plugins or partner scripts can now talk to GTM Kit through a simple JavaScript API, making CMP integrations easier.

Bugfixes:

Webhooks for Server-side Tracking on the WooCommerce integrations page no longer stay locked after entering an sGTM Container Domain on premium installs.

Other:

“Wait For Update” is now a proper number field with a sensible 500 ms default on new installs. Your existing value is kept.
Clearer warning on the Consent Mode page — if Cookiebot, Complianz, CookieYes, or Cookie Information already handles your consent, leave this setting off.
Introduced an internal automated test suite (PHPUnit + Vitest) and continuous integration across PHP 7.4–8.4 × WordPress 6.9. No functional change — every future release is now verified by unit and integration tests before shipping, raising the bar on quality and reliability.

[2.8.4] – 2026-04-23

Other:

Declared compatibility with WooCommerce Product Object Caching (product_instance_caching) introduced in WooCommerce 10.5. No functional change; resolves the “incompatible plugins” notice in WooCommerce → Settings → Advanced → Features.
Tested up to WooCommerce 10.7.
Tested up to WordPress 7.0.

[2.8.3] – 2026-03-18

Bugfixes:

Add error handling to WooCommerce blocks action handlers to prevent tracking errors from breaking checkout functionality or interfering with third-party plugins.

Other:

Tested up to WooCommerce 10.6.

[2.8.2] – 2026-02-17

Bugfixes:

Fix undefined array key warning for order-received query var in edge cases like certain payment gateway redirects or bot traffic.

[2.8.1] – 2026-01-30

Bugfixes:

Fixes correct detection of the premium plugin.

[2.8.0] – 2026-01-29

Enhancements:

Improved internal handling of plugin settings to make GTM Kit more reliable and easier to maintain, while ensuring full backward compatibility with existing configurations.

Other:

Tested up to WooCommerce 10.5.
Require WooCommerce 9.5.

[2.7.0] – 2026-01-06

Enhancements:

We have added a new template assistant to help you create your own custom templates for Google Tag Manager.
Add option to define a custom page that should be detected as the order-received page.
The debug info now includes a check to determine if WooCommerce purchase events have been recorded in the logs. This information is included in the debug data to assist with troubleshooting and support.

Bugfixes:

Fix edge case where quantity in the Datalayer was 0. Set a default quantity of 1 when the quantity element is missing.

Other:

Tested up to WooCommerce 10.3.
Tested up to WordPress 6.9.
Require WooCommerce 9.4.
Require WordPress 6.7.

[2.6.0] – 2025-09-24

Enhancements:

Add tracking on the product collection block.

Other:

Require WooCommerce 9.2.
Tested up to WooCommerce 10.2.

[2.5.1] – 2025-08-22

Bugfixes:

Force rounding values to 2 decimal places to fix rounding issues in edge cases.
In some cases the GTM container would not load after activating and deactivating settings in ‘Server-side Tagging (sGTM)’.

Other:

Tested up to WooCommerce 10.1.

[2.5.0] – 2025-08-05

Bugfixes:

The add_to_cart event did not fire in the all-products block.

Other:

Require WooCommerce 9.0.
Tested up to WooCommerce 10.0.

[2.4.4] – 2025-04-30

Bugfixes:

The $hook type hint in enqueue_page_assets was removed to avoid conflicts with plugins passing non-standard data types.

Other:

Introduced the gtmkit_options_set action and the gtmkit_process_options filter.
Fixed deprecation in Easy Digital Downloads.

[2.4.3] – 2025-04-15

Bugfixes:

Fix conflict with GTM Kit Woo in admin settings.

[2.4.2] – 2025-04-09

Bugfixes:

Fix fatal error when used together with MC4WP: Mailchimp for WordPress.

Other:

Tested up to WordPress 6.8.
Tested up to WooCommerce 9.8.

[2.4.1] – 2025-04-03

Security:

When debug logging is enabled, the Easy Digital Downloads integration was activaed sensitive customer information was logged to server error logs. If debug logging remains active in a production environment or if logs are not properly secured, it could lead to unauthorized access to personal data – CVE-2025-31001.

[2.4.0] – 2025-04-03

Removed feature:

The Event Inspector has been removed and is only available the premium version. It was often used in an inappropriate way where end-users unintentionally were shown debug data.

[2.3.2] – 2025-04-02

Security:

Permissions were not checked correct on the admin API

[2.3.1] – 2025-03-12

Bugfixes:

Fix a rare case of divisionByZero in calculation of discount.

Other:

Tested up to WooCommerce 9.7.

[2.3.0] – 2025-01-28

Bugfixes:

Fix an edge case fatal error in admin if $hook for some reason is missing.

Other:

Require WordPress 6.4.
Require WooCommerce 8.4.
Tested up to WooCommerce 9.6.

[2.2.2] – 2024-12-03

Other:

Tested up to WooCommerce 9.4.
Tested up to PHP 8.4.

[2.2.1] – 2024-10-29

Bugfixes:

If the cart and checkout endpoints were set to the same page in order to skip the cart the ‘checkout’ and ‘purchase’ events would not fire.

Other:

Tested up to WordPress 6.7.

[2.2] – 2024-10-16

Enhancements:

Added notifications and warnings for missing GTM container, debug log usage, auto-update and event inspector usage. These improvements aim to ensure smooth production operations.

Other:

Minor refactoring

[2.1] – 2024-10-01

Enhancements:

Added support for the Bricks theme builder.

Bugfixes:

In some cases other plugins or a theme could block GTM Kit from firing JS event like the one that fires the add_to_cart GTM event.

[2.0] – 2024-09-11

Breaking change:

Starting with GTM Kit version 2.0, the add_to_wishlist event is no longer supported in the free version of GTM Kit.

Enhancements:

A notifications handler has been added to communicate issues and notifications that require the user’s attention.
Added a warning when other Google Tag Manager plugins that may cause a conflict are active.
WooCommerce users are advised to install a supported SEO plugin to take advantage of a default category in data layer items.

Other:

Increased PHPStan analysis level to 6, enhancing static code analysis and catching potential issues earlier in the development process.
Require WordPress 6.3.
Require WooCommerce 8.3.
Require PHP 7.4.

[1.23.3] – 2024-08-22

Bugfixes:

Prevent fatal errors caused by invalid filter input from third-party plugins.
In WordPress versions prior to 6.6, the options pages fail to load due to a missing dependency.

[1.23.2] – 2024-08-13

Other:

Require WooCommerce 8.2.
Tested up to WooCommerce 9.2.

[1.23.1] – 2024-07-15

Enhancements:

The ‘Getting Started’ section the setup wizard has been updated with new content.

Bugfixes:

An upgrade function was causing problems for multisite installations leading lost configuration.

[1.23] – 2024-07-04

Enhancements:

Added an option to exclude selected user roles from tracking.
Improve the flexibility of GTM Kit integrations.

Other

Tested up to WooCommerce 9.1.
Tested up to WordPress 6.6.

[1.22.4] – 2024-05-30

Enhancements:

Improve log and support data.

Bugfixes:

There was a typo preventing the GTMKIT_WC_DEBUG_TRACK_PURCHASE constant from having any effect.

Other:

Tested up to WooCommerce 8.9.

[1.22.3] – 2024-05-22

Bugfixes:

The datalayer was not pushed when the container was disabled.

[1.22.2] – 2024-05-14

Bugfixes:

Fix items in add_shipping_info and add_payment_info.

[1.22.1] – 2024-05-13

Bugfixes:

wait_for_update was not printed in Google Consent Mode default settings.

[1.22] – 2024-05-08

Enhancements:

Added an Event Inspector for verifying that events are being pushed to the datalayer. You can now debug events without using GTM preview mode.
Added advanced GCM settings: ‘ads_data_redaction’, ‘url_passthrough’ and ‘wait_for_update’.
Updated the custom container loader for use with Stape.io.

[1.21] – 2024-04-15

Enhancements:

Added user-data in the datalayer containing user data formatted for the User-Provided Data variable so you don’t have to map it manually.
Added Google Tag Manager templates for Google Ads and Facebook.
Added dynamic template sections that allows for template updates wíthout updating the plugin.
The tutorial section is now dynamic and based on a feed, so we don’t have to update the plugin to include new tutorials.

Bugfixes:

JavaScript translations was not loaded correct.

Other:

Tested up to WooCommerce 8.8.

[1.20] – 2024-03-20

Enhancements:

Added a new section for GTM templates that you can use to configure the necessary Tags, Triggers and Variables in Google Tag Manager.
Added support for the ‘new_customer’ parameter on the ‘purchase’ event, which is used for customer acquisition reporting and Google Smart Shopping campaigns.
Added a debug log for debugging the ‘purchase’ event without make a purchase.
Improved the pagespeed of the control panel. The control panel is now loading significantly faster than before.

Bugfixes:

Add missing ‘currency’ on the ‘view_item’ event.
Add missing ‘payment_type’ on the ‘add_payment_info’ event.
On the ‘add_shipping_info’ and ‘add_payment_info’ events the items parameter was cast as an object instead of an array as it should be.

Other:

Require WooCommerce 8.0.

[1.19.1] – 2024-03-05

Bugfixes:

Scripts were not enqueued if the container was inactive.

Other:

Tested up to WooCommerce 8.7.

[1.19] – 2024-02-07

Enhancements:

Add option to fire a ‘load_delayed_js’ event, which can be used to delay JavaScript execution in Google Tag Manager.
This release comes with many behind-the-scenes improvements and general enhancements.
The script settings are the same on all pages and are now cached in the object cache for better performance.
The function to share system data with the support team has been improved with more data.
The code has been refactored for extendability.

[1.18.1] – 2024-01-08

Bugfixes:

Added missing flush of the ecommerce object on the select_item event.
1.17 introduced a bug that caused item brand to be limited to a product attribute.

Other:

Tested up to WooCommerce 8.5.
Minor refactoring.

[1.18] – 2024-01-02

Enhancements:

Add support for Google Consent Mode v2
Added a function to share system data with the GTM Kit support team. If you have registered a support request on WordPress.org and the GTM Kit support team has asked you to send your system data you can now do that in a secure way without posting any private information in the support forum.
Enhanced support for the select_item event in more WordPress themes. This update significantly improves the compatibility of the select_item event handling in themes such as Woodmart.

Bugfixes:

When adding a product to the cart from a product category page the quantity was not specified in the add_to_cart event.
On Single product pages a click on a quantity control would result in an undefined event.

[1.17] – 2023-12-04

Enhancements:

Added option to specify the Google Tag Manager environment.
Performance optimization through optimized database queries and general code improvements.
Added a filter to deactivate the container, so the container can be deactivated on specific pages.
Improved support of the ‘add_to_wishlist’ event. Themes and plugins just have to add the class ‘add_to_wishlist’ on the ‘Add to wishlist’ button.

Bugfixes:

Add missing _sbp cookie in the cookie keeper.
The constant GTMKIT_EDD_DEBUG_TRACK_PURCHASE and GTMKIT_WC_DEBUG_TRACK_PURCHASE was not overriding correct.
Because of recent changes in WooCommerce clicks on grouped products in a product list would be treated as add_to_cart and not select_item.
Clicks on variation products and grouped products in product lists was treated as add_to_cart events and are now select_item events as they should be.
If a product ID prefix was used the ‘add_to_cart’ event did not work on grouped products.

Other:

Refactoring code for simplicity and maintainability.

[1.16.2] – 2023-11-15

Bugfixes:

Fix critical JS bug.

[1.16] – 2023-11-15

Enhancements:

Add option to include customer data from Easy Digital Downloads on the purchase event.
Added the filter ‘gtmkit_datalayer_script’, which allows you to filter the datalayer script.
Added the constant ‘GTMKIT_EDD_DEBUG_TRACK_PURCHASE’, which allows users of Easy Digital Downloads to force tracking of purchase event on every page refresh for debugging.

Bugfixes:

Billing state and shipping stat was not included in the customer data on the ‘purchase’ event.

Other:

Tested up to WordPress 6.4
Tested up to WooCommerce 8.3

[1.15] – 2023-10-24

Enhancements:

Added support for the WooCommerce block ‘all-products’.
Inline scripts are now registered with the wp_add_inline_script insted of wp_head. This allows easy extension GTM Kit and implementation of a CSP (Content Security Policy).

Bugfixes:

The product ID Prefix was not added when a product variation was selected.
Tax was not added on the total on the add_shipping_info and add_payment_info events.

[1.14.2] – 2023-10-11

Bugfixes:

Items was not loaded correct in the Ease Digital Downloads begin_checkout event.
Fixes a problem where variation products would use the master product id.
Fixes an error when shipping was selected in the WooCommerce block cart.
Using variation product selection without including gtmkit_product_data would result in a JavaScript error.
Using the WooCommerce ‘All products’ block without including gtmkit_product_data would result in a JavaScript error.

[1.14.1] – 2023-10-06

Bugfixes:

Set custom page type in post sidebar was removed by mistake in 1.14
Fix possible naming collision with other GTM plugins

[1.14] – 2023-10-03

Enhancements:

There is a new admin GUI based on WordPress components and the admin is now more extendable.
We have added a more robust method of adding data attributes to the HTML.
The autoload of options has been optimized for better performance.

Bugfixes:

Flush cache after setting or updating an option.

Other:

Require WordPress 6.2
Require WooCommerce 7.6
Tested up to WooCommerce 8.2

[1.13.2] – 2023-09-25

Bugfixes:

Fixes a bug that prevented the option to import settings from other plugins on first install.

[1.13.1] – 2023-08-31

Bugfixes:

Fixes a bug where a REST request could fail because the function is_plugin_active() is not ready.

Other:

Tested up to WooCommerce 8.1

[1.13.0] – 2023-08-30

Enhancements:

Add option to set Google Consent Mode default settings if a Consent Management Platform is not used.
Added support for import of more plugin configurations.
Prevent Consent Management Platforms from blocking GTM Kit and the Google Tag Manager container. This can be overridden with the filter hook ‘gtmkit_header_script_attributes’.

Bugfixes:

Fix a bug that in some cases would cause a namespace problem.

Other:

Declare compatibility with the WooCommerce Cart and Checkout blocks.
Comply with WordPress Coding Standards.

[1.12.2] – 2023-08-15

Bugfixes:

Fixes an error when no payment gateways are defined.
Fixes empty items in begin_checkout event.

[1.12.1] – 2023-08-07

Bugfixes:

A custom datalayer name was not registered correct

[1.12] – 2023-08-07

Enhancements:

Improved support for the WooCommerce cart and checkout blocks
Added the class input-needed to the block list of the add_to_cart event
Added option to import plugin settings from GTM4WP in the setup wizard
Improved the setup wizard with option to enable essential settings

Other:

Use global object for script data and settings
Require WooCommerce 7.1
Require WordPress 6.1
Tested up to WordPress 6.3
Tested up to WooCommerce 8.0

[1.11.1] – 2023-07-07

Bugfixes:

Cast transaction_id to string. According to the GA4 documentation transaction_id should be a string as it allows numbers, letters, and special characters like dashes or spaces.

[1.11] – 2023-07-04

Enhancements:

Added Just-The-Container mode for those with simple needs. This option reduces the functionality to just the GTM container code.
Added help section with GTM container import files

Other:

Removed option to delay the container script by 2 seconds.
WooCommerce tested up to: 7.9
Added PHPStan to ensure code quality
Refactored code and improved code quality
All PHP classes are marked ‘final’
The Gulp build tool has been removed and we are now using NPM as a build tool

[1.10] – 2023-06-12

Enhancements:

Added setup wizard for onboarding new users

Other:

Updated dependencies
Implemented Tailwind

[1.9] – 2023-04-19

Enhancements:

Added option to include the customer data in the data layer on the “purchase” event.
Added the constant ‘GTMKIT_WC_DEBUG_TRACK_PURCHASE’, which allows you to force tracking of purchase event on every page refresh for debugging.

Bugfixes:

Fixed a bug where Easy Digital Download Pro was not detected.

Other:

Changed required capability from ‘install_plugins’ to ‘manage_options’.
WooCommerce tested up to: 7.6.

[1.8] – 2023-04-03

Enhancements:

Added ‘add_to_wishlist’ event when used together with the most popular wishlist plugins ‘YITH WooCommerce Wishlist’ and ‘TI WooCommerce Wishlist’.
Improve compatibility with other plugins and customisations.
Added item_variant to the items element in the datalayer.
Added ‘coupon’ to the datalayer.
Added option to log helpful messages and warnings to the browser log.

Bugfixes:

Fixed a bug where inline styles would be stripped from the HTML.
Fixed af bug where items in the ‘view_cart’ event had double brackets.

[1.7.1] – 2023-03-23

Bugfixes:

The begin_checkout event did not contain data layer values for ecommerce.currency and ecommerce.value

[1.7] – 2023-03-20

Enhancements:

Added support for the new WooCommerce checkout block
Added meta box on posts where you can enter the page type to be included in the data layer.
Added the filter gtmkit_admin_capability, which allows you to set the capability required to manage the plugin options.
Added option to share anonymous data with the development team to help improve GTM Kit.

Bugfixes:

Type cast the item value to prevent string values in the data layer
On installations of Easy Digital Download where the Confirmation Page was not configured the Purchase event would not fire.

Other:

Minor styling of the dashboard
Updated the tutorial section
Improved some help texts
Added missing translation strings
WordPress tested up to 6.2
WooCommerce tested up to: 7.5.

[1.6.2] – 2023-02-27

Bugfixes:

Backwards compatibility with PHP 7.2. Trailing comma in function calls is only available since PHP 7.3

[1.6.1] – 2023-02-23

Enhancements:

Added declaration of plugin compatibility with WooCommerce High-Performance Order Storage.

Other:

WooCommerce tested up to: 7.4

[1.6] – 2023-01-24

Enhancements:

Added support Easy Digital Downloads for the events: view_item, add_to_cart, begin_checkout, purchase
Added support for primary product category in Rank Math SEO

Other:

WooCommerce tested up to: 7.3
Refactored integrations
Added missing translation string

[1.5.3] – 2023-01-03

Enhancements:

Align text domain with GlotPress making the plugin compatible with translations from WordPress.org

[1.5.2] – 2023-01-03

Enhancements:

Added better help texts.
Fixed typos.

[1.5.1] – 2022-12-20

Enhancements:

Added better support for the Google Ads remarketing tag.

[1.5] – 2022-12-12

Enhancements:

Add option til select the Google business vertical value to include in all items. This is used for Google Ads remarketing.
Add option to add a prefix to the item IDs.

Bugfixes:

Fix wrong currency value in the Data Layer.

[1.4.5] – 2022-11-26

Enhancements:

By default the Contact Form 7 integration script will only load on pages where the Contact Form 7 script is registered.
Tutorials and help text have been improved

Bugfixes:

Fix datalayer_name collision when both WooCommerce and CF7 integration are active.

Other:

WooCommerce tested up to: 7.1

[1.4.4] – 2022-11-20

Enhancements:

Added tutorials section to the dashboard.

Bugfixes:

Fix the description og the CF7 integration.

[1.4.3] – 2022-11-08

Bugfixes:

The items object was limited to 1 on the checkout page.

[1.4] – 2022-11-03

Enhancements:

Added options to add user data to the datalayer (logged in, user ID, user role).
Added option to limit view_item event on variable products to the master product instead of pushing the view_item event on both the master and selected variation.
Added edit button on container dashboard

Bugfixes:

Clear the previous ecommerce object before add_to_cart.
Set default option for CF7 integration

Other:

Added support links in help section

[1.3.3] – 2022-10-30

Bugfixes:

Fix custom datalayer name in CF7.

[1.3.1] – 2022-10-06

Bugfixes:

A custom container domain would not be used in the noscript container.

[1.3] – 2022-09-30

Enhancements:

Added compatibility with WooCommerce High-Performance Order Storage.
Added DNS prefetch for the Google Tag Manager host.
Added Contact Form 7 Integration.
New admin dashboard.
New admin navigation.

Other:

Cleaned up and formatted code.

[1.2] – 2022-09-13

Enhancements:

Option to include the defined page type. I.e. post, page, product, category, cart, checkout etc.

[1.1] – 2022-09-11

Enhancements:

Option to include the permalink structure of the product base, category base, tag base and attribute base in the datalayer.
Option to include the path of cart, checkout, order received adn my account page in the datalayer.

Bugfixes:

Fixes a bug where an aggressive wp_kses filter prevents add to cart tracking on product catagory pages.

Other:

Disable WooCommerce settings if WooCommerce is not active
Update logo.

[1.0] – 2022-09-06

The plugin has been used in production for a year and is considered stable. This is the first public release.