Drupal 10, the latest version of the open-source digital experience platform with even more features, is here.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. As of v7.x-1.5 a submodule (Metatag:Importer) is provided to convert data from Nodewords to Drupal 7, and as of v8.x-1.12 a migrate path is provided for upgrading to Drupal 9.
Dependencies
Features
- Works on Drupal 7, 9.0+! As of 8.x-1.17, Drupal 8 is no longer supported.
- 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 (see full list).
- 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.
- Multi-lingual support using the Entity Translation module and translation support using the Internationalization (i18n) module.
- Full support for entity revisions and workflows based upon revision editing, including compatibility with the Revisioning and Workbench Moderation modules.
- D7: Customize meta tags for specific paths (or other conditions) using Context and included Metatag:Context submodule.
- D7: Customize meta tags for custom pages built using Panels and Views using included submodules.
- D7: Individual permissions for each meta tag can be enabled (see README.txt).
- D7: Meta tags can be optionally added to admin pages.
- Exportable default meta tag configuration.
- Extendable and flexible API for define new meta tags.
- D7: Support for Devel Generate (sub-module).
Resources
- Full documentation is available: Metatag for Drupal 7, Metatag for Drupal 9
- Video tutorial explaining improvements in v1.5 and providing a suggested setup process.
- Drupal core release blockers for Metatag
- A blog post from markconroy on how to use tokens to use core's Media fields with Metatag.
Alternatives and similar modules
- Metatags Quick - Uses the Field API to store its meta tag data. Metatag on D7 does not use the Field API for reasons of flexibility and usability. On D9 Metatag does use Field API so the Metatags Quick maintainers will hopefully be helping on Metatag's D9 port.
- Page title - Functionality was merged into Metatag.
- Open Graph meta tags - Functionality was merged into Metatag.
- Refresh - Functionality was merged into Metatag.
- EasyMeta - Very limited functionality compared to Metatag.
- Metatag iTunes - Functionality was merged into Metatag.
- Sandboxes:
Code Mirrors
The code has been made available on two other repository services for people who have specific technical needs:
- Github: https://github.com/DamienMcKenna/metatag
- Bitbucket: https://bitbucket.org/DamienMcKenna/metatag
These repositories are considered write-only, pull requests to those repositories will be recreated on d.o. and pushed back out once the changes are reviewed & approved.
Credits
Maintained since 2012 by Damien McKenna; initial development (2010-2012) by Dave Reid.
Project information
- Module categories: SEO
371,126 sites report using this module
- Created by apaderno on , updated
Drupal 10 is here!
Version 8.x-1.22 and 2.0.0 will be compatible with both Drupal 9 and 10. See #3252150: Drupal 10 compatibility for Metatag for details.
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Lots of bug fixes, some new APIs in preparation for the upcoming v2 release.
Development version: 8.x-1.x-dev updated 24 Jan 2023 at 22:28 UTC
- Testing result: PHP 7.3 & MySQL 5.7, D9.5.2 372 pass all results
Fixes a regression in the last release.
Development version: 7.x-1.x-dev updated 26 Oct 2022 at 17:59 UTC
- Testing result: PHP 7.4 & MySQL 8, D7 263 pass all results














