How to Add Meta Tags to Header in Magento 2
Vinh Jacker | 03-17-2025
As you might already know, the HTML <head> section of the page includes different meta tags, CSS, JS files definition, JS code’s pieces, etc. Normally, no complex logic is needed to add some proper content there. However, in various situations, we will need to insert several elements which depend on the configuration of the system into the head section.
If you have been working with Magento 1, you will find out that it’s easy to operate with the contents of the head section. However, in the newest Magento version, adding meta tags to the header might be a bit tricky for you. Because of that, in today’s post, I will guide you on how to add blocks and templates, more specifically how to Add Meta Tags to the head section in Magento 2.
Magento SEO Services
by Mageplaza
Let experienced professionals optimize your website's ranking
Learn more
Add Meta Tags to Header
In order to add <meta> tags to your layout’s <head> element, you need to create a theme extending file which is similar to this: app/design/frontend/<Vendor>/<theme>/Magento_Theme/layout/default_head_blocks.xml.
By default, \Magento\Framework\View\Page\Config\Renderer is the class by which the <meta> tags are rendered by. There are five types of meta, and a catch-all (the default) is rendered by this class:
- og
- charset
- content_type
- x_ua_compatible
- media_type
- “default” case
You can use the following as an examples to include in your layout themes:
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
<head>
<!-- This will create a tag like '<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">' -->
<meta name="x_ua_compatible" content="IE=edge,chrome=1"/>
<!-- This will create a tag like '<meta property="og:type" content="article"/>'' -->
<meta name="og:type" content="article"/>
<!-- This will create a tag like '<meta charset="UTF-8">' -->
<meta name="charset" content="UTF-8"/>
<!-- This will create a tag like '<meta http-equiv="Content-Type" content="content-type-value"/>' -->
<meta name="content_type" content="content-type-value"/>
<!-- This tag will not render (see \Magento\Framework\View\Page\Config\Renderer for details) -->
<meta name="media_type" content="any-value"/>
<!-- This will create a tag like '<meta name="my_custom_type" content="my_custom_value"/>' -->
<meta name="my_custom_type" content="my_custom_value"/>
</head>
</page>
Conclusion
Above I have just provided you the method to add meta tags to header in Magento 2. I hope it is helpful for you. Should you have any questions or new ideas, feel free to leave a comment below.
Jacker is the Chief Technology Officer (CTO) at Mageplaza, bringing over 10 years of experience in Magento, Shopify, and other eCommerce platforms. With deep technical expertise, he has led numerous successful projects, optimizing and scaling online stores for global brands. Beyond his work in eCommerce development, he is passionate about running and swimming.
Related Post
Mageplaza Announces Official Separation from Avada Group
Mageplaza is pleased to announce a significant milestone in our journey as we officially separate from the Avada Group to operate as an independent company.
Magento 2.4.8 Release: What's New In This Latest Enhancements?
In this article, we’ll explore the standout new features and enhancements that make the Magento 2.4.8 Beta version truly special.
Explore the latest from Mageplaza in January 2025, with new modules and updates designed to enhance your Magento e-commerce experience.
AngularJS and ReactJS: Which Framework Should We Use?
AngularJS vs ReactJS: Which framework is right for your project? In this article, we aim to discover strengths, weaknesses, and best use cases of them.
Mageplaza Announces Official Separation from Avada Group
Mageplaza is pleased to announce a significant milestone in our journey as we officially separate from the Avada Group to operate as an independent company.
Magento 2.4.8 Release: What's New In This Latest Enhancements?
In this article, we’ll explore the standout new features and enhancements that make the Magento 2.4.8 Beta version truly special.
Explore the latest from Mageplaza in January 2025, with new modules and updates designed to enhance your Magento e-commerce experience.
AngularJS and ReactJS: Which Framework Should We Use?
AngularJS vs ReactJS: Which framework is right for your project? In this article, we aim to discover strengths, weaknesses, and best use cases of them.
& Maintenance Services
Make sure your store is not only in good shape but also thriving with a professional team yet at an affordable price.
Get Started