Adding GTM to Magento

Adding GTM to Magento

August 29, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding GTM to Magento

Installing Google Tag Manager on Magento: A Best Practice Guide

As an experienced e-commerce developer, I often receive queries about integrating tools like Google Tag Manager (GTM) into existing Magento sites without relying on plugins. This post will guide you through a clean, efficient method to add GTM to your Magento store while avoiding unnecessary bloat from third-party extensions.

Understanding the Magento Codebase

Magento is built using PHP and follows a modular architecture that separates concerns effectively. The core frontend files responsible for rendering page structure are located in:

app/design/frontend/<Vendor>/<Theme>/template/page/html

Among these, the head.phtml file is our primary target as it contains the <head> section of every Magento page.

Identifying the Body Tag Location

To find where the <body> tag is loaded, we need to navigate to:

app/design/frontend/<Vendor>/<Theme>/template/page/html/body.phtml

This file defines the structure for the main content area of your pages.

Avoiding HardcodedGTM Snippets

Some developers suggest hardcoding GTM script tags directly into this body.phtml file. However, this method violates several best practices:

  1. It couples the theme tightly with the GTM implementation.
  2. It makes updating or removing GTM challenging without modifying core files.
  3. It increases the risk of conflicts if you ever decide to switch themes.

Creating a Custom Magento Module

The recommended approach is creating a custom Magento module (a collection of interrelated functionality). By following this path, we can maintain separation of concerns and ensure clean, portable code.

  1. Create your custom module folder:
mkdir app/code/YourCompany/TagManager
  1. Define the module configuration:

Create app/code/YourCompany/TagManager/etc/module.xml with the following content:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="YourCompany_TagManager" setup_version="1.0.0">
        <sequence>
            <module name="Magento_Theme"/>
        </sequence>
    </module>
</config>
  1. Override the body.phtml file:

Create app/code/YourCompany/TagManager/view/frontend/templates/html/body.phtml and replace its contents with your GTM script:

<?php echo $this->helper('Magento\Theme\Helper\Data')->getHeadJs(); ?>
<script>
  (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
  new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
  j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
  'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
  })(window,document,'script','dataLayer','GTM-XXXX');
</script>
<?php echo $this->getChildHtml('head.scripts'); ?>

Replace 'GTM-XXXX' with your actual GTM container ID.

  1. Enable your module:

Log in to your Magento admin panel and navigate to “Stores” > Configuration > Advanced > Advanced. Set the Enabled field for “YourCompany_TagManager” to Yes.

Conclusion

By following this approach, you’ve successfully integrated Google Tag Manager into your Magento site without relying on plugins or modifying core files. This method ensures clean, portable code that respects Magento’s architecture and best practices.

Remember that maintaining a clean codebase is not just about aesthetics—it’s about ensuring your project remains flexible, maintainable, and resilient to future changes.

For more insights on Magento development best practices, feel free to explore our Magento Development Services at Laravel Company.

Extensions Themes

Our network