The Metatag module allows you to automatically manage structured metadata on your website. It helps improve search engine optimization by providing tags for descriptions and keywords, and it also controls how your content appears when shared on social media platforms like Facebook and Twitter. You can set global defaults, define settings per entity type, and override them for individual content items.
The Metatag module allows you to automatically provide structured metadata, aka "meta tags", about a website. In the context of search engine optimization, when people refer to meta tags they are usually referring to the meta description tag and the meta keywords tag that may help improve the rankings and display of a site in search engine results. In addition, the module provides support for meta tags (Open Graph Protocol from Facebook, Twitter Cards from Twitter) that allow control of how content appears when shared on social networks.
This project is the offical successor of the Nodewords module.
Dependencies
Features
- Supports a large number of commonly used meta tags, including the page title, canonical URL, description, etc, and for Facebook's Open Graph, Twitter Cards and Dublin Core via included submodules.
- Global settings to control meta tags on all pages.
- Per entity and per entity bundle to control default meta tags for all items of a certain type, e.g. all nodes of a certain content type.
- Ability to override meta tags on each entity object, e.g. to override meta tags on an individual node.
- Full support for entity revisions and workflows based upon revision editing.
- Customize meta tags for custom pages built using Views using included submodules.
- Individual permissions for each meta tag can be added via the Metatag Advanced Permissions.
- Extendable and flexible API for defining new meta tags.
Resources
- Full documentation is available: Metatag for Drupal
- A blog post from markconroy on how to use tokens to use core's Media fields with Metatag.
- How to create custom meta tags in 2.1.0; excellent blog post by Naveen Valecha.
Recommended / related modules
Some modules are available that extend Metatag with additional or complimentary functionality. Many related modules are available from the Metatag ecosystem page and that is the best place to find them.
The following are a noteworthy additions to Metatag's main functionality:
- Context Metadata:
Allow assignment of meta tags based upon different system contexts, e.g. per
path. - ECA Metatag:
Use Event-Condition-Action rules to dynamically set meta tags. - Maxlength:
If this module is installed, meta tags that have a maximum length defined in
the settings will have that maximum length enforced; this may be disabled in
the settings if it proves to be problematic. - Metatag AI:
AI-powered metadata generation and suggestions. - Metatag Async Widget:
Provides an asynchronous widget for editing meta tags. - Metatag Page Heading:
Automatically generates meta tags using page headings. - Metatag Webform:
Adds meta tag support to Webform pages. - Real-time SEO for Drupal:
Uses the [YoastSEO.js library and service](https://yoast.com/) to provide
realtime feedback on the meta tags. - Token Custom:
Allows creation of custom tokens without writing code. - Token Modifier:
Modify or transform token output before being used in metadata. - Token OR:
Provides a means to output a second token if the first one is empty, which can
be very useful for complex content architectures.
The following modules make additional meta tags available:
- Metatag Cxense:
Adds support for the Cxense meta tags used by their DMP and Insight services. - Metatag Google Scholar:
Adds support for a number of meta tags used with the Google Scholar system. - Schema.org Metatag:
Extensive solution for adding schema.org / JSON-LD support to Metatag.
Credits
Maintained since 2012 by Damien McKenna; initial development (2010-2012) by Dave Reid.
Past sponsors
- Mediacurrent
- Lullabot
- Palantir
- Acquia
Depends on
Dependencies of the latest stable release
- Token
- field Drupal core
Required by
25 tracked projects depend on this one
- Schema.org Metatag 67,809 sites
- Real-time SEO for Drupal 25,335 sites
- Metatag Asynchronous Widget 2,400 sites
- Acquia Drupal Starter Kit Common 1,855 sites
- External Hreflang 1,663 sites
- ECA Metatag 871 sites
- Metatag AI 518 sites
- Lupus Custom Elements Renderer 491 sites
- GraphQL Metatag 468 sites
- OG default image 312 sites
- Droopler 212 sites
- AGLS Metadata 131 sites
- Seeds SEO 115 sites
- Commerce ML Starter 42 sites
- Metatag Simple Widget 24 sites
- SEO URLs (pretty URLs) 23 sites
- Schema.org Metatag AI 10 sites
- Metatag Search.gov 10 sites
- Metatag AI Generate 6 sites
- OpenFed 6 sites
- Canvas Page Metatag 4 sites
- Metatags import CSV 1 sites
- BrightEdge Autopilot Page Publisher
- Raw Formatter [Meta Tag Formatter]
- Custom Meta
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 2.2.0 | Stable | 10–11 | Requires Drupal 10.3+. Multiple attributes on custom meta tags; placeholder to blank out inherited meta tags; new meta tags. | Sep 23, 2025 | |
| 2.2.x-dev | Dev | 10–11 | Sep 4, 2025 | ||
| 2.1.2 | Stable | 9–11 | Bug fixes. | Sep 4, 2025 | |
| 2.1.1 | Stable | 9–11 | PHP 8.4 fixes, other minor fixes. | May 29, 2025 | |
| 2.1.0 | Stable | 9–11 | Drupal 11 support; UI for creating custom meta tags; custom route tags can support path arguments; support Comment, Commerce Store entities, etc | Nov 7, 2024 | |
| 2.0.3 | Stable | 9–11 | Drupal 11 support, misc fixes. | Nov 7, 2024 |