--- title: "GTM Kit Changelog" date: 2022-09-10 author: "GTM Kit" --- # GTM Kit Changelog You can follow the development on our [Github repository](https://github.com/tlamedia/gtm-kit). Constributions are welcome! ## Changelog ### \[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](https://www.cve.org/CVERecord?id=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.