Troubleshooting

Troubleshooting & known issues

• When using custom page template files, e.g., page--front.tpl.php, it is important to ensure that the following code is present in the template file: or Without one of these being present the meta tags will not be displayed.
• An alternative method to fixing the missing-tags problem is to change the page region used to output the meta tags. The region used may be controlled from the settings page, it is recommended to test different options to identify the one that works best for a specific site.
• Using Metatag with values assigned for the page title and the Page Title module simultaneously can cause conflicts and unexpected results. It is strongly recommended to convert the Page Title settings to Metatag and just uninstall Page Title entirely. See https://www.drupal.org/node/2774833 for further details.
• When customizing the meta tags for user pages, it is strongly recommended to not use the [current-user] tokens, these pertain to the person viewing the page and not e.g., the person who authored a page.
• Certain browser plugins, e.g., on Chrome, can cause the page title to be displayed with additional double quotes, e.g., instead of: <title>The page title | My cool site</title> it will show: <title>"The page title | My cool site"</title> The solution is to remove the browser plugin - the page's actual output is not affected, it is just a problem in the browser.
• If the Administration Language (admin_language) module is installed, it is recommended to disable the "Force language neutral aliases" setting on the Admin Language settings page, i.e. set the "admin_language_force_neutral" variable to FALSE. Failing to do so can lead to data loss in Metatag.