{"body":{"value":"\u003Ch2\u003ERequirements\u003C\/h2\u003E\n\u003Cp\u003EThe \u003Ca href=\u0022https:\/\/www.drupal.org\/project\/metatag\u0022 rel=\u0022nofollow\u0022\u003EMetatag module\u003C\/a\u003E is required, as Schema.org Metatag is technically a Metatag submodule.\u00a0\u003C\/p\u003E\n\u003Cp\u003EFor more information about the Metatag module and how to set it up, see \u003Ca href=\u0022https:\/\/www.drupal.org\/docs\/8\/modules\/metatag\u0022 rel=\u0022nofollow\u0022\u003Eits documentation\u003C\/a\u003E.\u00a0\u003C\/p\u003E\n\u003Ch2\u003EBackground info\u003C\/h2\u003E\n\u003Cp\u003EFor more information about structured data and JSON-LD examples:\u003C\/p\u003E\n\u003Cul\u003E\n\u003Cli\u003E\u003Ca href=\u0022https:\/\/developers.google.com\/search\/docs\/guides\/intro-structured-data\u0022 rel=\u0022nofollow\u0022\u003Ehttps:\/\/developers.google.com\/search\/docs\/guides\/intro-structured-data\u003C\/a\u003E\u00a0- if you are new to structured data you should definitely read this\u00a0carefully.\u003C\/li\u003E\n\u003Cli\u003E\u003Ca href=\u0022https:\/\/schema.org\/docs\/full.html\u0022 rel=\u0022nofollow\u0022\u003Ehttps:\/\/schema.org\/docs\/full.html\u003C\/a\u003E\u003C\/li\u003E\n\u003C\/ul\u003E\n\u003Ch2\u003EConfiguration\u003C\/h2\u003E\n\u003Cp\u003EEnable the module and those submodules\u00a0which pertain to the content types your site has. Start simple and get the settings right, before you add a dozen more submodules. E.g. if your site is a news site, we\u0027d recommend schema_metatag, schema_web_site and schema_article.\u003C\/p\u003E\n\u003Cp\u003EGo to admin\/config\/search\/metatag\u00a0and start with the global configuration. You will find that schema_metatag and its submodules simply add more fieldsets to this screen. If you have configured metatags before there is nothing really new here.\u00a0For the global configuration you will likely only use schema_web_site. Be sure to use tokens as much as you can to keep your settings dynamic.\u00a0\u003C\/p\u003E\n\u003Cp\u003EThen continue to the other metatag settings and add in, or override, more schemas. For example, for a news site with a content type of News, you\u0027d add schema_article to the mix on the News content type. It will look something like this:\u003C\/p\u003E\n\u003Cp\u003E\u003Cimg alt=\u0022schema_article configuration form - Drupal 8\u0022 height=\u0022772\u0022 src=\u0022\/files\/project-images\/screenshot_301.png\u0022 width=\u00221022\u0022 \/\u003E\u003C\/p\u003E\n\u003Cp\u003EAs is usual with metatag module, you can override these sitewide settings on any node edit form. You will find the same form as in the previous step\u00a0under the Metatag vertical tab, and can edit things as needed to create your desired output for this node. Generally\u00a0it is recommended to stick with sitewide defaults if possible.\u003C\/p\u003E\n\u003Ch2\u003EValidation\u003C\/h2\u003E\n\u003Cp\u003EOnce you have configured your structured data output you \u003Cem\u003Eneed to validate it\u003C\/em\u003E, and fix any issues that exist\u003Cem\u003E.\u003C\/em\u003E\u00a0You can use one of these validators:\u003C\/p\u003E\n\u003Cul\u003E\n\u003Cli\u003E\u003Cs\u003E\u003Ca href=\u0022https:\/\/search.google.com\/structured-data\/testing-tool\u0022 rel=\u0022nofollow\u0022\u003Ehttps:\/\/search.google.com\/structured-data\/testing-tool\u003C\/a\u003E\u003C\/s\u003E (now \u003Ca href=\u0022https:\/\/webmasters.googleblog.com\/2020\/07\/rich-results-test-out-of-beta.html\u0022 rel=\u0022nofollow\u0022\u003Edeprecated\u003C\/a\u003E)\u003C\/li\u003E\n\u003Cli\u003E\u003Ca href=\u0022https:\/\/search.google.com\/test\/rich-results\u0022 rel=\u0022nofollow\u0022\u003Ehttps:\/\/search.google.com\/test\/rich-results\u003C\/a\u003E\u003C\/li\u003E\n\u003Cli\u003E\u003Ca href=\u0022https:\/\/json-ld.org\/playground\/\u0022 rel=\u0022nofollow\u0022\u003Ehttps:\/\/json-ld.org\/playground\/\u003C\/a\u003E\u003C\/li\u003E\n\u003C\/ul\u003E\n\u003Cp\u003EWord to the wise: Don\u0027t skip this step! Also we recommend that you occasionally re-validate your pages, and\/or watch for issues in Google Search Console.\u003C\/p\u003E\n\u003Ch2\u003ERecommended Workflow for Tokens and\u00a0Overrides\u003C\/h2\u003E\n\u003Cp\u003EThe best way to use this functionality is to take advantage of tokens to pull the right information from the content item, setting up the appropriate tokens for each content type on the global metatag settings page. When configured this way, the JSON-LD on each node will automatically contain the right values, values which match the content being viewed.\u003C\/p\u003E\n\u003Cp\u003EIt is possible to configure the metatag module to override each individual node with different values by adding a metatag field to the content type. In this workflow you assume editors will manually input content directly into the metatag form when they edit the nodes. But there are several reason why this workflow is likely to be a problem:\u003C\/p\u003E\n\u003Cul\u003E\n\u003Cli\u003EValidation of Schema.org data can be challenging. The best way to be sure it validates is to configure it globally using tokens to pull in contextual data, test the results, and lock it down.\u003C\/li\u003E\n\u003Cli\u003EIf you expose the configuration to editors, they will be able to change all values, not just one or two. They may not realize that their changes will invalidate the results, or even know how to validate them.\u003C\/li\u003E\n\u003Cli\u003EEditors are unlikely to know how to use tokens, or what to do with tokens that are already there.\u003C\/li\u003E\n\u003Cli\u003EThe metatag fields are not large enough to contain large paragraphs of text typed in manually. There\u0027s plenty of room to pull in multiple paragraphs of text using a field token, but not by typing the text into the metatag field.\u003C\/li\u003E\n\u003Cli\u003EOne of the expectations of Schema.org is that the JSON-LD represents the same information that is already on the page. It should not contain different values. Using tokens to pull the existing data into the metatags is consistant with that goal. Typing different information into individual nodes is not.\u003C\/li\u003E\n\u003C\/ul\u003E","summary":"","format":"1"},"upload":[],"field_documentation_status":"No known problems","field_summary":"Use and configuration of Schema.org Metatag module is the same as any other Metatag submodule.","og_group_ref_documentation":{"uri":"https:\/\/www.drupal.org\/api-d7\/node\/2942667","id":"2942667","resource":"node"},"field_related_content":[],"field_tags":[],"field_asciidoc_source_file":null,"og_membership":[],"og_membership__1":[],"og_membership__2":[],"og_membership__3":[],"og_group_ref_documentation__og_membership":[],"og_group_ref_documentation__og_membership__1":[],"og_group_ref_documentation__og_membership__2":[],"og_group_ref_documentation__og_membership__3":[],"flag_project_issue_follow_user":[{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/45874","id":45874,"resource":"user"},{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/102134","id":102134,"resource":"user"},{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/108450","id":108450,"resource":"user"},{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/3620173","id":3620173,"resource":"user"},{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/2661375","id":2661375,"resource":"user"},{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/281751","id":281751,"resource":"user"}],"nid":"2942674","vid":"12210747","is_new":false,"type":"documentation","title":"Basic Usage","language":"en","url":"https:\/\/www.drupal.org\/docs\/contributed-modules\/schemaorg-metatag\/basic-usage","edit_url":"https:\/\/www.drupal.org\/node\/2942674\/edit","status":"1","promote":"0","sticky":"0","created":"1517963334","changed":"1613392220","author":{"uri":"https:\/\/www.drupal.org\/api-d7\/user\/281751","id":"281751","resource":"user"},"comment":"2","comments":[{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/12473683","id":12473683,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/12930017","id":12930017,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13269672","id":13269672,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13269857","id":13269857,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13269861","id":13269861,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13748784","id":13748784,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749007","id":13749007,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749014","id":13749014,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749019","id":13749019,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749135","id":13749135,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749950","id":13749950,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749952","id":13749952,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13749956","id":13749956,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13999110","id":13999110,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13999128","id":13999128,"resource":"comment"},{"uri":"https:\/\/www.drupal.org\/api-d7\/comment\/13999318","id":13999318,"resource":"comment"}],"comment_count":"16","comment_count_new":false,"feeds_item_guid":null,"feeds_item_url":null,"feed_nid":null,"flag_flag_tracker_follow_user":[],"flag_tracker_follower_count":"6","has_new_content":null,"last_comment_timestamp":"1613392220"}