Change log for Magento Google Tag Manager Extension
Version 2.8.0 (May 20, 2026)
General:
- - Important! Google Tag Manager Basic has become paid for Magento Open Source.
Features:
- - Added an option to hide product price in the events for specific customer groups (Plus & Extra).
- - Added an option to limit the number of items for the view_item_list event (Plus & Extra).
- - Added an option to ignore specific IPs in the server container (Extra).
- - Implemented the functionality to add custom item-scoped and event-scoped dimensions (Extra).
Improvements:
- - Enhanced bot detection in the server-side tracking (Extra).
- - Significant server container improvements (Extra).
Compatibilities:
- - Added compatibility with the Magento 2 One Step Checkout extension by Aheadworks.
Fixes:
- - Fixed an error on order creation when the afterpay-global/module-afterpay was used (Extra).
- - Fixed the incorrect currency attribution when tracking missing orders (Extra).
- - Fixed an issue with the same 'magefanUniqueEventId' in the begin_checkout, add_shipping_info, and add_payment_info events (Extra).
- - Resolved the intermittent login issues that occurred when the server container was enabled (Extra).
Version 2.7.4 (January 19, 2026)
Improvements:
- - Improved the Breeze theme compatibility (Plus & Extra).
- - Now, the server-side tracking session data is stored for 90 days (Extra).
Fixes:
- - The "mf_gtm_session_id" is now stored instead of the entire quote object to avoid potential issues.
- - Fixed the incorrect refund value (Extra).
- - Resolved an issue with invalid HTML in the admin panel.
Version 2.7.3 (October 16, 2025)
Features:
- - An option to submit cart data (sold products, their quantity, and price) for sale conversions to get cart conversions reporting in Google Ads (Plus & Extra).
Improvements:
- - Improved the engagement time calculation for the server-side tracking (Extra).
Compatibilities:
- - Firecheckout compatibility (Extra).
Fixes:
- - Resolved an issue with order refunds through the admin panel for products that no longer exist.
- - Corrected the tracking to only fire upon user selection of a child product and ignore non-user-firing events (Extra).
Version 2.7.2 (September 3, 2025)
Optimizations:
- - Minor changes to comply with the Magento Coding Standard.
- - Optimized tracking of the events related to configurable products (Extra).
General:
- - Extended the list of conversion variables for the server-side tracking (Extra).
Version 2.7.1 (August 12, 2025)
Fixes:
- - Fixed error during customer registration Magefan\\GoogleTagManagerPlus\\Model\\GetCustomerData::executeCustomer(): Argument #1 ($customer) must be of type Magento\\Customer\\Model\\Customer, Magento\\Customer\\Model\\Data\\Customer given (Plus & Extra).
Version 2.7.0 (August 7, 2025)
Improvements:
- - Improved CSP whitelist.
- - Added "customer_firstname", "customer_lastname", "customer_email", "customer_dob", "customer_gender", "customer_telephone", "customer_postcode", "customer_city", "customer_region", "customer_country_id" params to the data layer with the hashed customer data (Plus & Extra).
- - Improved getting ecomm_pagetype param value.
- - Added view_item event on configurable product option select (Extra).
- - Improved Server-side tracking (Extra).
- - - Added "customer_id", "item_variant" param to the data layer.
General:
- - Moved "customer_identifier" and "customerGroup" data layer param from Basic to Plus extension edition.
Compatibilities:
- - Improved compatibility with Magefan Rich Snippets and Google Shopping Feed extensions.
Version 2.6.10 (June 19, 2025)
General:
- - Minor code improvements.
- - Improved scroll tracking for the GTM Server Container (Extra).
Features:
- - The item_brand and ecomm_prodid parameters are now added to all eCommerce events (Extra).
- - Added customer consent signals for the GTM Server Container (Extra).
- - A new "Google Tag Gateway" option (Extra).
Compatibilities:
- - Added compatibility with the Redsys payment method.
Version 2.6.9 (May 6, 2025)
General:
- - Minor code improvements.
Compatibilities:
- - Added compatibility with PHP 8.4.
Fixes:
- - Fixed the "Magento\Framework\Exception\InputException: Can not resolve reCAPTCHA parameter" error.
Version 2.6.8 (April 22, 2025)
General:
- - Improved the related, cross-sell, and up-sell products view tracking. The event is now tracked only when a customer scrolls to these blocks (Plus & Extra).
- - Improved CSP settings.
Features:
- - Track scroll events with the server side tracking (Extra).
- - Track purchases only for specific order statuses with the server side tracking (Extra).
- - Related products view tracking on the Magefan Blog post pages (Plus & Extra).
Compatibilities:
- - Added compatibility with the Hyva Checkout.
Version 2.6.7 (January 29, 2025)
Fixes:
- - Fixed the JavaScript error "MagefanJs is undefined". An error occurred only on v2.6.6 when moving JavaScripts to the bottom of the page is enabled, with skipping moving GTM script.
Version 2.6.6 (January 27, 2025)
Features:
- - Added compatibility with Breeze Theme.
- - Added compatibility with the by Magefan.
- - Improved server-side tracking with GTM server container (Extra).
- - Minor code improvements.
Version 2.6.5 (November 7, 2024)
Features:
- - Minor code improvements.
- - Added select_item event tracking (Plus & Extra).
Fixes:
- - Fixed an issue with the wrong item price on the Add to Cart event for configurable product. The item price has been always set as base (Plus & Extra).
Version 2.6.4 (September 23, 2024)
Features:
- - Improved Google Ads Remarketing in Server Container (Extra).
- - Added "new_customer" data layer for purchase event (Plus & Extra).
- - Improved missing purchase transactions tracking (Extra).
- - Option to Enable/Disable Web Container without removing Web Container Public ID or Script.
- - Server Container Improvements (tracking of session start, user page time spent) (Extra).
Version 2.6.3 (June 17, 2024)
Features:
- - Improved the Server Container (Server Side tracking) for Google Ads.
Fixes:
- - Fixed JavaScript errors on some Magento versions that use HTML modification (error happened only on 2.6.0-2.6.2).
Version 2.6.2 (June 12, 2024)
Features:
- - Minor improvements.
Version 2.6.1 (June 11, 2024)
Fixes:
- - Fixed an issue with GTM Extension v2.6.0 on Magento v2.3.x.
Version 2.6.0 (June 7, 2024)
Features:
- - Security improvements. Use Magento SecureRenderer to whitelist an inline script.
- - Rearranged extension config. Removed the "Server Side Tracking" section and moved the options to the "Server Container" section.
- - Added an option to disable purchase event (Order creating) in the admin panel (Extra).
- - Added ability to track first visit and session start, session count in Server Side Tracking via GTM Server Container (Extra).
Fixes:
- - Fixed an issue with displaying real-time users in Google Analytics 4 when the Server Side Tracking was enabled (Extra).
Version 2.5.8 (June 1, 2024)
Features:
- - Improved Data Layer Values and JSON Container file for Google Ads Remarketing (Plus & Extra).
Fixes:
- - Fixed the JS "require is not defined" error on the Hyva theme.
Version 2.5.7 (May 3, 2024)
Features:
- - Improved GTM Server Container performance (Extra).
- - Added server container debug preview (Extra).
- - Minor code impromevents.
Version 2.5.6 (April 18, 2024)
Features:
- - Fixed an issue with the v2.5.5 during import to the GTM: Unknown variable “Magefan DLV - Customer Email Hash” found in another variable. Edit the variable and remove the reference to the unknown variable.
Version 2.5.5 (April 9, 2024)
Features:
- - The option to include/exclude tags from prices works not only on the purchase events but all events.
- - Improved the ecomm_pagetype identifier.
- - Added an option to prevent the execution of third-party JavaScripts for Google Analytics and Google Ads.
- - Minor code improvements.
- - Measure activity across platforms with User ID.
Version 2.5.4 (March 20, 2024)
Features:
- - Added new "Load GTM Script Before Consent" option for default Magento cookie restriction setting.
- - Added tracking of the refund event (Extra).
Improvements:
- - Improved Google Consent Mode.
- - Improved JSON file export.
Version 2.5.3 (March 6, 2024)
Features:
- - Added Google Consent Mode V2 compatibility when using the default Magento cookie consent popup.
Version 2.5.2 (February 29, 2024)
Features:
- - Minor code improvements.
Note: if you have used the Measurement Protocol before v2.5.2, export the JSON file and import it to the GTM after updating..
- - Added option to exclude shipping and tax amount from purchase event value.
- - Improved missed purchase detection (Extra).
Version 2.5.1 (February 9, 2024)
Fixes:
- - Magento JavaScript customer data sections list is empty (GTM Plus) (Extra).
- - Transaction duplication if Web Container and Server Container or Measurement Protocol is enabled (Extra).
- - Compatibility issues with PHP7.1 (Extra).
- - Fixed the issue with dataLayer JavaScript code displaying on the page, related to some custom JS sliders.
Version 2.5.0 (January 5, 2024)
Features:
- - Option to use GTM Server Container or GA4 Measurement Protocol to track only missing purchase transactions (Extra).
- - Option to define Google Ads Tag ID (GTM Plus) (Plus & Extra).
- - Code Refactor.
- - Added compatibility with the Google Tag Manager Server Container (Extra).
Version 2.4.2 (November 7, 2023)
Features:
- - Ability to generate and export JSON Container on the website level.
- - Minor code improvements.
Fixes:
- - 500 PHP error on rest/V1/mfgtm/dlp ajax request.
- - On Magento 2.3.x dataLayer for cart items has zero price.
Version 2.4.1 (September 20, 2023)
Features:
- - Added Google Enhanced Conversions for Google Ads Conversion Tracking (Plus & Extra).
- - Added "ecomm_pagetype" parameter to the dataLayer for Google Ads Remarketing (Plus & Extra).
Version 2.4.0 (August 16, 2023)
Features:
- - Added "customer_identifier" paramether (sha256 hash of order customer email) to the purchase event.
- - Google Analytics 4 Measurement Protocol for server-side eCommerce tracking (Extra).
- - REST API endpoints for Headless PWA storefront Google Analytics 4 tracking (Extra).
- - Minor code improvements.
- - Prevent duplication of purchase events.
- - Compatibility with 2c2p payment method module.
Version 2.3.1 (July 4, 2023)
Features:
- - Page Speed Optimization option. If enabled GTM JavaScript will be loaded only after users first click, scroll, or mouse touch.
- - Option to select Product ID as Product Identifier.
- - Improved CSP Whitelist.
Fixes:
- - Some events are duplicated.
Version 2.3.0 (June 28, 2023)
Features:
- - Removed the "Loader Type" option in the extension settings and added "Google Tag Manager Installation Method" instead with two options to install GTM script with the Public ID or with the BODY and HEAD scripts.
- - Important! Users who used stape.io loader need to Generate Web GTM code and set it in "Head Script" and "Body Noscript".
- - Cart and order items now have prices including tax in the data layer.
- - Added customer group name to the data layer.
- - Added full categories path as one string to the products data layer.
- - Improved json container export for Google Ads.
- - Minor code improvements.
Version 2.2.0 (May 29, 2023)
Features:
- - Tracking orders created in admin panel, purchase event in the admin panel (Extra).
- - Option to include product categories in the dataLayer.
- - GDPR/CCPA/LGPD compliance settings.
- - Auto space trimming for config values.
- - Added compatibility with default Magento cookies.
- - stape.io Custom GTM and GA4 Loader (Extra).
- - Minor code improvements.
Fixes:
- - Magento 2.3.x JS error: sectionConfig.getSectionNames is not a function (Plus & Extra).
Version 2.1.0 (April 24, 2023)
Features:
- - Added compatibility with Hyva Theme.
- - Track sign-in (Extra).
- - Track create an account (Extra).
- - Track searches (Extra).
- - Improved compatibility with Magento 2.3.x.
- - Minor code improvements.
Fixes:
- - JS error on the checkout page when the module is disabled in the admin panel (GTM Plus) (Plus & Extra).
- - Instead of a brand name dataLayer contains only brand ID.
Version 2.0.2 (April 15, 2023)
Features:
- - Performance improvement (Page Speed Improvement).
Fixes:
- - Error on Magento 2.3.x: Class Magento\Framework\View\Helper\SecureHtmlRenderer does not exist.