GTM Kit Changelog

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

Changelog

[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.