Structured Data Markup Helper - Search Console Help

This testing tool will tell you about any missing fields that you must provide to help Google understand the page, and for some data types it can provide a ... SkiptomaincontentStructuredDataMarkupHelperThe StructuredDataMarkupHelperhelpsyoumarkupelementsonyourwebpage sothatGooglecanunderstandthedataonthepage.OnceGoogleunderstandsyourpagedatamoreclearly,itcanbepresentedmoreattractivelyandinnewwaysinGoogleSearch.InadditionifyousendHTML-formattedemailtoyourcustomers,MarkupHelpercanshowyouhowtochangeyouremailtemplatessothatGmailcanpresentthedatatotheuserinnewandusefulways. OpentheStructuredDataMarkupHelper Examples: Event:Ifyoumarkuptheeventsonyoursite,thenexttimeGooglecrawlsyoursitetheeventdatawillbeavailableforrichsnippetsonsearchresultspages: Email:Ifanemailaboutyourflightcontainsmarkup aboutyourflightreservations,Gmailcandisplaythisinformationinyourdesktopclientoryourpersonalfeed:   Ifyoudon'tfeelcomfortableaddingcodetoyourwebsite,youcantryouttheDataHighlighter instead. Ifyou'retechnicallyminded,learnaboutstructureddataandaddmarkuptoyoursitemanually. Markupawebpageoremail YoucanmarkupelementsineitheranHTMLwebpageoranHTMLemail. Markup awebpage Hereishowtomarkupelementsina webpage. OpentheStructuredDataMarkupHelper. Selectthe Website tab. Choosethetypeofpagethatyouaremarkingup.Forexample,amoviepageoraneventpage.Youcanhavemultipleitemsonasinglepage,butwerecommendthatallitemsareofthesametype(forexample,allmoviesorall events) EntereithertheURLofanexistingpageortherawpageHTML.ForaURL,besurethatthepageisavailabletoanyonewithoutloggingin.(YoucantestpageaccessbyopeninganincognitowindowinChromeandtryingtovisityourpage.Ifyoucanreachit,you'refine.) SelectStartTagging. Highlightpartsofthepagewithimportantinformation(forexample,thestarttimeonanevent page),thenidentifythetype ofinformationinthedropdownthatappears("Starttime"). Ifyouhavecomplexdatestrings,orarehavingtroubletaggingyourdates,see Advanceddatetagging. Ifyouneedtoaddinformationthatisnotvisibleinyourpage,see Addmissingdata. IfyouneedtoremoveatagthatStructuredDataMarkupHelpergenerated,see Removetags. Besuretoprovideallinformationrequiredforyour specificdatatype.IntheMyDataItemspaneyouwillseealistofallpossiblevaluesforeachitem,withtherequiredvalueslabeled. Forexample,foraneventyoumustprovideaneventname, location,andstartdate. Whenyou'vefinishedtaggingalltheappropriatedataonthepage,select CreateHTML togeneratethepagecode. Chooseanoutputformat:thedefaultisJSON-LD(preferredbyGoogle),butyoucanalsochooseMicrodata.Eithercopyandpastethecodefromtheoutputwindow orselect Download.Howyouuse thecodedependsontheformat: ForJSON-LD:Copyandpastethegeneratedcodeintothebodyofyourexistingpage. ForMicrodata:ReplaceyourpagewiththegeneratedHTML. Totestyourcode,copyandpastethegeneratedcodeintotheRichResulttest.ThistestingtoolwilltellyouaboutanymissingfieldsthatyoumustprovidetohelpGoogleunderstandthepage,andforsomedatatypesitcanprovideapreviewofhowyourpagemightlooklikeinGoogleSearchResults. ItcantakeafewweeksforGoogletofindyournew pagecode. Ifyourdataiscrawled,complete,andcorrect,itcanappearasrichresults.Ifrichresultsaren'tappearingforyoursite,seepossiblereasonswhy Markup anemail HereishowtomarkupanHTML-formattedemail: OpentheStructuredDataMarkupHelper. SelecttheEmailtab. Choosethetypeofinformationyouwillmarkup.Forexample,abusreservationorproductorder. EntertheHTMLofyouremail. SelectStartTagging. Highlightpartsoftheemailwithimportantinformation(forexample,thereservationnumberforabusreservation),thenselecttheinformationtypeinthedropdownthatappears("Reservationnumber"). Ifyouhavecomplexdatestrings,orarehavingtroubletaggingyourdates,see Advanceddatetagging. Ifyouneedtoaddinformationthatisnotvisibleinyouremail,see Addmissingdata. IfyouneedtoremoveatagthatStructuredDataMarkupHelpergenerated,see Removetags. Besuretoprovideallinformationrequiredforyour specificdatatype. IntheMyDataItemspaneyouwillseealistofallpossiblevalues,withtherequiredvaluesmarked.Ifyoudonotprovideallrequiredvalues,Googlewillnotbeabletoprocesstheemail. Ifthealerticon ()showsnexttoataggedelement,selectthedatanexttotheicon,reviewthetagging,and dooneofthefollowing: Ifthetaggingisincorrect,selectthe X nexttothedata. Thenre-tagthedata. Ifthetaggingiscorrect,selectthe alerticonitself ()andselect Clearwarning. Whenyou'vefinishedtagging,selectCreateHTMLtogeneratetheHTMLthatyoushouldusefortheemail.ThedefaultisJSON-LD,becauseGoogleprefersJSON-LD,butyoucanalsochooseMicrodata.SelectDownloadorjustcopyandpastethegeneratedHTML. ForJSON-LD:Copyandpastethegeneratedcodeintothebodyofyouremail. ForMicrodata:ReplaceyouremailwiththegeneratedHTML. Totestyourcode,sendanemailtoaGmailaccount orusetheemailschemavalidator. Saveandresumeeditingapageoremail Tosaveyourmarkupinthecurrentstate,bookmarkthepageinyourbrowser. StructuredDataMarkupHelperwillsaveyourstateforamonth,includingallmarkupvalues.   Removetags YoucanundosomeorallofthetagsStructuredDataMarkupHelperhascreated. Toclearaspecifictag: Selectonthetagintheexamplepageoremail. Fromthepop-upmenuthatdisplaysafteryouselectthetag,selectCleartag. Alternatively,youcanfindthedataintheMyDataItemscolumn,restthemousepointeronthedata,andselecttheXthatappears.   Toclearalltags: Becareful:youcannotundoaclearalltagsrequest.Instead,you'llneedtostarttaggingagainfromscratch.Ifyour content alreadyhasmarkup,Markup Helperwillnotremovetheexistingmarkup.ClearingalltagswillonlyremovethetagsthatMarkup Helperhasadded. Selectthegearicon. SelectClearalltagsfromthispage. Advanceddatetagging StructuredDataMarkupHelperunderstandsdatesinmanyformatsaslongasthedatesincludemonth,day,andyear.Youcansupplyanymissingdata(suchastheyear)byaddingmissingdatatothepageset. Ifyoursamplecontentdisplaysdatesinonepiece(forexample,June4,2012),it'srecommendedthatyoutagdatesinonepiece.Thefewertagsyoucreate,thefasteryourtaggingwillbeandthemoreaccurateMarkup Helperwillbe. Tagdatesinonepiece: Starttaggingdataasdescribedin TagapageorTaganemail. OntheTaggerpage,usethemousetoselectadate.Forexample,selectthefollowing:June4,2012 SelectDate>Date/timeorrangefromthecontextmenuthatdisplays. Markup HelperaddsthedatetotheMyDataItemscolumn. Finishtagging thepage asdescribedin TagapageorTaganemail. Taggingdatesinseparatepieces Somecontentdisplaysdateinformationinseparatepiecesoruseslabelstoidentifytheseparatedatecomponents.Forexample,apagethatlistsmultipleeventsmightdisplaythemonthandyearonceatthetop,anddisplayspecificdaysnexttoeachevent.Ifyourcontentdisplaysdatesinseparatepieces,you'llneedtotagdatesinseparatepieces.  NotethatMarkup Helper doesnotunderstanddatesthatarebothtaggedinseparatepiecesandthatspecifyarange(suchasJune4-5 and 2012). Tagdatesinseparatepieces: Starttaggingdata asdescribedin TagapageorTaganemail. OntheTaggerpage,usethemousetoselectpartofadate.Forexample,selectthefollowing:June SelectDate>Advanced>datepiece fromthecontextmenuthatdisplays.Forexample,select Date>Advanced>Month. Markup HelperaddsthedatetotheMyDataItemscolumn. Continuetaggingpiecesofthedateuntilyou'vetaggedallofthedatathat'savailableforthedate. Finishtaggingasdescribedin TagapageorTaganemail. Examplesofdatetags Herearesomeexamplesofdatesyoucantag: Asingledate.Forexample,youcantag anyofthefollowing: June4,2012 4June 2012 6/4/12 -Yourtagscaninclude otherdelimitersandfour-digityears aswell,suchas6-4-2012.Whennumericaldatesareambiguous, Googleassumesthatthefirstnumberisthemonth.Forexample, 6/4/12 isintrepretedasJune4,2012,while 13/4/12 wouldbeinterpretedasApril13,2012. Youcantagmultipledatesonapage.Forexample,ifyoutagJune4,2012andJune6,2012,theevent willbe intepreted asoccuringtwice:onceonJune4thandonceonJune6th. Arangeofdays. Forexample,June4-72012 Notethatdelimiter betweenthebeginningandendingdaysneedstobe adash(-). Dateswithtimes.Forexample,youcantaganyofthefollowing: June4,20123pm -atimefollowedbyamorpm.Google usesnormalbusinesshourstointerpet timesnotfollowedbyamorpm.Forexample,11 wouldbeinterpretedas11amand 2 wouldbeinterpretedas2pm. June4,201215:00 -militarytime June4,20123pmEST or  June4,20123pm-5:00 -TimeswithatimezoneorwithaUTC/GMToffset. June4,20122-3pm or  June4-5,2012 2-3pm -Timerangeswithorwithoutadaterange. Datesinseparatepieces.Youcanusetheadvancedtaggingoptiontotagthefollowingseparate piecesoftext asasingledate: Day:Tuesday,June4Year:2013 June4|Time:7:30pm-9:30pm and 2012 Googledoesnotrecognizedaterangesthathavebeensplitintomultipletags.Forexample,thefollowingtagsarenotvaliddatetags: June4-5 and 2012 Manuallyspecifythedateformat Markup Helperassumesthatthedatesinyourcontentfollowtheformattingrulesassociatedwiththecontent'slanguage.Forexample,ifapage'slanguageisen-US,Markup Helperassumesthat12-06-12meansDecember6th,2012.Ifapage'slanguageisen-GB,Helperassumesthat12-06-12meansJune12th,2012.Markup Helperautomaticallydeterminesthepage'slanguageandthereforethedate'sformattingrules. TooverrideMarkup Helperandspecifyadifferentdateformat: SelectthegeariconandselectSettings. IntheSettingspopup,selectaformat fromtheDateformatlist. SelectSave. Addmissingdata Ifyourexamplecontentismissingdata,suchastheyearofanevent,youcanspecifyavalue.StructuredDataMarkupHelperwilladdmarkupforthevalue. Youcanaddmissingdataatanytime,andyoucanchangeordeleteitifneeded. Toadd,change,ordeletemissingdata: Select Addmissingtags at thebottomoftheMyDataItemscolumn.  Doanyofthefollowing: AddavaluebyselectingatagfromtheSelectatag list.Thentype thevaluein thetextbox.Forexample,selectCategoryandtypeIrishTraditionalMusic. DeleteexistingdatabyselectingtheXinatextbox. Editexistingdatabychangingthevalueinthetextbox. Select Save.  MarkupHelper displaysthespecifiedvalueunderMyDataItems. Changethepagelanguage StructuredDataMarkupHelperautomaticallydetectsthelanguageofyourexamplecontent soitcanbetterunderstandthedataonyourpage.IfthemarkupthatMarkup Helpercreatesisincorrect,youcanexplicitlytellMarkup Helperaboutthelanguageyou'reusing. Tomanuallyspecifythelanguage: SelectthegeariconandselectSettings. IntheSettingspopup,selectalanguagefromtheSitelanguagelist. Select Save Whatisschema.org? schema.orgisacollaborationbyGoogle,Microsoft,andYahoo!toimprovethewebbycreatingacommonvocabularyfordescribingthedataontheweb.Ifyouaddschema.orgmarkuptoyourHTMLpages,manycompaniesandproducts—includingGooglesearch—willunderstandthedataonyoursite.Likewise,ifyouaddschema.orgmarkuptoyour HTML-formattedemail,otheremailproductsinadditiontoGMailmightunderstandthedata. Youcanusedifferenttypesofmarkuptodescribeyourdatawiththeschema.orgvocabulary.MarkupHelpercanshowyouhowtousemicrodataandJSON-LD. Formoreinformationaboutschema.org,seeschema.orgFAQ. WhatareJSON-LDandmicrodata? JSON-LDandmicrodataaretwodifferentwaystomarkupyourdatausingtheschema.orgvocabulary.GoogleprefersJSON-LDforwebcontent. JSON-LD JSON-LDusesaJavaScriptobjectinyourHTMLpagetodefinedata.Forexample,here'sJSON-LDthatdescribesanevent: { "@context":"http://schema.org", "@type":"Event", "name":"SlimWhitmanTribute", "startDate":"2013-07-06", "location":{ "@type":"Place", "name":"HollywoodBowl" } } WhenaddingJSON-LD,MarkupHelperprefers toaddmarkuptoexistingHTMLelements.Forexample,ifyouhighlightaneventcodedas

MyEvent