Supported structured data attributes and values - Google ...

Attributes and schema.org annotations. Attributes are one of the ways that the product data you submit to Merchant Center is organized. Each attribute contains ... SkiptomaincontentSupportedstructureddataattributesandvaluesUsestructureddatamarkuponyourproductlandingpagestohelpGoogleretrieveup-to-dateinformationaboutyourproductsandoffersdirectlyfromyourwebsite.AnystructureddatamarkupthatissupportedbyMerchantCenterwillhavecorrespondingattributesandacceptedvalues,aslistedintheproductdataspecification.Yourstructureddatamustbematchedtothecorrespondingvaluesandattributes. Notallattributesaresupportedbyschema.orgatthistime. Attributesandschema.organnotations AttributesareoneofthewaysthattheproductdatayousubmittoMerchantCenterisorganized.Eachattributecontainsasinglepieceofinformationaboutaproduct,suchastheproduct'stitleordescription.Accuratelymatchingtheschema.orgvaluetothecorrespondingproductdataspecificationattributeswillleadtofewererrorswhenvalidatingyourfeed. Note:Ifyou’reusingautomaticitemupdates,makesuretospecifytheschema.orgpropertiesprice,priceCurrency,andavailabilitytoincreaseitsaccuracy.Learnmoreaboutautomaticitemupdates ProductDataAttribute Schema.orgProperty TypeandDescription Thefollowingattributesarefromtheschema.orgProducttype title name Text description description Text image_link image AvalidimageURL item_group_id inProductGroupWithID Text AparentSKU,requiredtogroupallvariantproductsbelongingtothesameproductgrouptogether. gtin gtin8,gtin12,gtin13,gtin14,isbn Text TheGTINthatuniquelyidentifiesyourproduct. Specifyonlyoneoftheseschema.orgproperties. IfyouuseGTINvalues,theymustbethecorrectlengthandcontainthecorrectcheckdigit. material material Text pattern pattern Text mpn mpn Text brand brand Text gender audience.suggestedGender Text UsetheaudiencepropertytospecifyaPeopleAudienceobjectwhichitselfspecifiessuggestedGender.Validvaluesarethosedefinedbythegenderattribute: male female unisex age_group audience.suggestedMinAge,audience.suggestedMaxAge Number(inyears) UsetheaudiencepropertytospecifyaPeopleAudienceobjectwhichitselfspecifiessuggestedMinAgeandsuggestedMaxAge. Validvaluesarethosedefinedbytheage_groupattribute: Dataspec Schema.orgvalue   suggestedMinAge newborn 0 infant 0.25 toddler 1.0 kids 5.0 adult 13 Dataspec Schema.orgvalue   suggestedMaxAge newborn 0.25 infant 1.0 toddler 5.0 kids 13.0 adult Notspecified color color Text size size Text size_type size.sizeGroup Text ValidvaluesarefromtheWearableSizeGroupEnumerationtype.Atmosttwovaluescanbespecified.Theyaremappedtofeedvaluesasfollows: Dataspec schemavalue big WearableSizeGroupBig maternity WearableSizeGroupMaternity petite WearableSizeGroupPetite plus WearableSizeGroupPlus regular WearableSizeGroupRegular tall WearableSizeGroupTall size_system size.sizeSystem Text ValidvaluesarefromtheWearableSizeGroupEnumerationtype.Theyaremappedtofeedvaluesasfollows: Dataspec schemavalue AU WearableSizeSystemAU BR WearableSizeSystemBR CN WearableSizeSystemCN DE WearableSizeSystemDE EU WearableSizeSystemEurope FR WearableSizeSystemFR IT WearableSizeSystemIT JP WearableSizeSystemJP MEX WearableSizeSystemMX UK WearableSizeSystemUK US WearableSizeSystemUS Thefollowingschema.orgpropertiesarefromtheOffer_type,whichmustbenestedwithinaproductusingtheoffersproperty(seeexamplesbelow). link url AvalidURLtoyourproduct. price price priceCurrency or: priceSpecification.price priceSpecification.priceCurrency price:Number.Submittedwithoutcurrencysymbols,thousandsseparators,orspaces(forexample,'1498.99'). priceCurrency:Text.Submittedina3-letterISO4217format(forexample,USD,GBP,EUR),thecurrencyshouldmeetthelanguageandcurrencyrequirementsforyourtargetcountry. Note:priceandpriceCurrencycanbeprovideddirectlyundertheOfferinstanceorindirectlyviaapriceSpecificationpropertyoftypepriceSpecification availability availability ValidvaluesarefromtheItemAvailabilitytype.They’remappedtofeedvaluesasfollows: Dataspec Schema.orgvalue in_stock InStock LimitedAvailability OnlineOnly out_of_stock Discontinued InStoreOnly OutOfStock SoldOut preorder PreOrder PreSale condition itemCondition ValidvaluesarefromtheOfferItemConditiontype.They’remappedtofeedvaluesasfollows: Dataspec Schema.orgvalue new NewCondition refurbished RefurbishedCondition used DamagedCondition UsedCondition ExamplesusingJSON-LD SingleProduct { "@context":"https://schema.org/",  "@type":"Product",  "sku":"trinket-12345",  "image":"https://www.example.com/trinket.jpg",  "name":"Nicetrinket",  "description":"Trinketwithcleanlines",  "gtin14":"12345678901234",  "brand":{   "@type":"Thing",   "name":"MyBrand"  },  "offers":{   "@type":"Offer",   "url":"http://www.example.com/trinket_offer",   "itemCondition":"https://schema.org/NewCondition",   "availability":"https://schema.org/InStock",   "price":"39.99",   "priceCurrency":"USD"   } } Variantsgroupedusing"inProductGroupWithID" Certainproductsmaycontainmultiplevariants,suchascolororprice.Toshowthevariants,youneedtoaddadditionalstructureddatatoshowthattherearemultipleproductsononepage.Thisexamplehasoneproductthatvariesincolorandsize.Oneofthecolorsisonlyavailableinonesize.Theothercolorisavailableintwosizes.TheinProductGroupWithIDpropertyisrequiredtoshowthatall3variantsbelongtothesameproductgroup. Example [  {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"44E01-M11000",   "gtin14":"98766051104218",   "inProductGroupWithID":"44E01",   "image":"https://www.example.com/coat_small_green.jpg",   "name":"Smallgreencoat",   "description":"Smallwoolgreencoatforwinter",   "brand":{    "@type":"Brand",    "name":"Goodbrand"   },   "audience":{    "@type":"PeopleAudience",    "suggestedGender":"unisex",    "suggestedMinAge":13   },   "color":"green",   "size":"small",   "offers":{    "@type":"Offer",    "url":"https://www.example.com/coat?s=s&c=g",    "priceCurrency":"USD",    "price":39.99,    "itemCondition":"https://schema.org/NewCondition",    "availability":"https://schema.org/InStock"   }  },  {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"44E01-K11000",   "gtin14":"98766051104201",   "inProductGroupWithID":"44E01",   "image":"https://www.example.com/coat_small_darkblue.jpg",   "name":"Smalldarkbluecoat",   "description":"Smalldarkbluecoatforwinter",   "brand":{    "@type":"Brand",    "name":"Goodbrand"   },   "audience":{    "@type":"PeopleAudience",    "suggestedGender":"unisex",    "suggestedMinAge":13   },   "color":"lightblue",   "size":"small",   "offers":{    "@type":"Offer",    "url":"https://www.example.com/coat?s=s&c=lb",    "priceCurrency":"USD",    "price":39.99,    "itemCondition":"https://schema.org/NewCondition",    "availability":"https://schema.org/InStock"   }  },  {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"44E01-X1100000",   "gtin14":"98766051104391",   "inProductGroupWithID":"44E01",   "image":"https://www.example.com/coat_large_darkblue.jpg",   "name":"Largedarkbluecoat",   "description":"Largedarkbluecoatforwinter",   "brand":{    "@type":"Brand",    "name":"Goodbrand"   },   "audience":{    "@type":"PeopleAudience",    "suggestedGender":"unisex",    "suggestedMinAge":13   },   "color":"lightblue",   "size":"large",   "offers":{    "@type":"Offer",    "url":"https://www.example.com/coat?s=l&c=lb",    "priceCurrency":"USD",    "price":49.99,    "itemCondition":"https://schema.org/NewCondition",    "availability":"https://schema.org/InStock"   }  } ] Multipleunrelatedproductsononelandingpage Whenyourpagecontainsmultipleunrelatedproductsandeachproducthasitsownstructureddataannotation,eachannotationmustcontaininformationthatidentifieswhichproductitisreferringto. Forexample,it’srecommendedtoprovidetheSKU(ID[id]attribute)ortheGTIN([gtin]attribute)ineachannotation.Ifyoudon’tprovidethisinformation,theproductsonyourlandingpagemaynotbematchedtoyourstructuredproductdata.Learnmoreaboutsettingupstructureddataonlandingpages Example [  {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"trinket-12345",   "image":"https://www.example.com/trinket.jpg",   "name":"Nicetrinket",   "description":"Trinketwithcleanlines",   "gtin14":"12345678901234",   "brand":{    "@type":"Brand",    "name":"MyBrand"   },   "offers":{    "@type":"Offer",    "url":"http://www.example.com/trinket_offer",    "itemCondition":"https://schema.org/NewCondition",    "availability":"https://schema.org/InStock",    "price":"39.99",    "priceCurrency":"USD"   }  },  {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"racket-12345",   "image":"https://www.example.com/racket.jpg",   "name":"Niceracket",   "description":"RacketforTennis",   "gtin14":"12345678901235",   "brand":{    "@type":"Brand",    "name":"MyBrand"   },   "offers":{    "@type":"Offer",    "url":"http://www.example.com/racket_offer",    "itemCondition":"https://schema.org/NewCondition",    "availability":"https://schema.org/InStock",    "price":"59.99",    "priceCurrency":"USD"   }  } ] EnergyEfficiency Schema.orgsupportsenergyefficiencylabelingofproductsusingtheEnergyConsumptionDetailstype,whichcanbespecifiedforaProductthatusestheEnergyConsumptionDetailsproperty. ProductDataAttribute Schema.orgProperty TypeandDescription Thefollowingattributesarefromtheschema.orgEnergyConsumptionDetailstype. energy_efficiency_class energyEfficiencyScale Validvaluesarefromtheschema.orgEUEnergyEfficiencyEnumerationtype.Usethevaluemappingtablebelowthistable. min_energy_efficiency_class energyEfficiencyScaleMin AddundertheinstanceofEnergyConsumptionDetailsthatwasusedtospecifytheenergy_efficiency_classattributeandusethesamemappingtabletoselectthevalue.Requiredwhenmax_energy_efficiency_classisspecified. max_energy_efficiency_class energyEfficiencyScaleMax AddundertheinstanceofEnergyConsumptionDetailsthatwasusedtospecifytheenergy_efficiency_classattributeandusethesamemappingtabletoselectthevalue.Requiredwhenmin_energy_efficiency_classisspecified. ValuesforenergyEfficiencyScale,energyEfficiencyScaleMin,andenergyEfficiencyScaleMaxarefromtheschema.orgEUEnergyEfficiencyEnumerationenumerationtypeandaremappedtovaluesforthe3energyefficiencyattributesintheproductdataspecificationasfollows. Productdataspecificationvalue Schema.orgenumerationvaluefromthe EUEnergyEfficiencyEnumerationtype A+++ EUEnergyEfficiencyCategoryA3Plus A++ EUEnergyEfficiencyCategoryA2Plus A+ EUEnergyEfficiencyCategoryA1Plus A EUEnergyEfficiencyCategoryA B EUEnergyEfficiencyCategoryB C EUEnergyEfficiencyCategoryC D EUEnergyEfficiencyCategoryD E EUEnergyEfficiencyCategoryE F EUEnergyEfficiencyCategoryF G EUEnergyEfficiencyCategoryG Example Thefollowingexampleillustrateshowtospecifyenergyefficiencyinformationusingschema.org.TheexamplespecifiestheEUenergyefficiencyclass"C"withscale"A+"to"G"forawaterheater. {   "@context":"https://schema.org/",   "@type":"Product",   "sku":"1234-5678",   "image":"https://www.example.com/waterheater.jpg",   "name":"Waterheater",   "description":"Largecapacitywaterheater",   "gtin14":"12345678901231",   "mpn":"WH1234",   "brand":{     "@type":"Brand",     "name":"ExampleWaterHeaterBrand"   },   "offers":{     "@type":"Offer",     "url":"http://www.example.com/hotwaterheater",     "itemCondition":"https://schema.org/NewCondition",     "availability":"https://schema.org/InStock",     "price":1799.00,     "priceCurrency":"EUR",     "hasEnergyConsumptionDetails":{       "energyEffiencyScale":"https://schema.org/EUEnergyEfficiencyCategoryC",       "energyEffiencyScaleMin":"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",       "energyEffiencyScaleMax":"https://schema.org/EUEnergyEfficiencyCategoryF"     }   } } Example Thefollowingexampleillustrateshowtospecifysizetypeandsizesystemusingschema.org. Theexamplespecifiesthesize"XL"intheUSsizesystemwithsizegroups"big"and"tall"forat-shirt. {     "@context":"https://schema.org/",     "@type":"Product",     "sku":"12345",     "image":"https://www.example.com/tshirt.jpg",     "name":"ClassicT-Shirt",     "description":"All-cottont-shirtinclassiccut",     "gtin14":"12345678901234",     "brand":{       "@type":"Brand",       "name":"MyBrand"     },     "size":{       "@type":"SizeSpecification",       "name":"XL",       "sizeSystem":"US",       "sizeGroup":["big","tall"]     },     "offers":{       "@type":"Offer",       "url":"http://www.example.com/tshirt",       "itemCondition":"https://schema.org/NewCondition",       "availability":"https://schema.org/InStock",       "price":"24.99",       "priceCurrency":"USD"     }   } Testyourmarkup Testyourschema.orgimplementationwiththeRichResultstool.VisittheGoogleSearchConsoleHelpCentertolearnmoreaboutusingthetool,debugginganyissues,andinterpretingyourresultsinthetool. Requirementsforstructureddatamarkup StructureddatamarkupmustbepresentintheHTMLreturnedfromthewebserver.Thestructureddatamarkupcan’tbegeneratedwithJavaScriptafterthepagehasloaded. Yourlandingpagecannotchangebasedoninformationaboutthecustomer,suchasifyouadaptpricesbasedonacustomer’sIPaddressorbrowsertype. Structureddatamustmatchthevaluesthatareshowntothecustomer.Providingincorrectdataonyourproductlandingpagesisaviolationofourwebdeveloperguidelines. GooglerecommendstheuseofJSON-LDforyourstructureddata. Wasthishelpful?Howcanweimproveit?YesNoSubmitNeedmorehelp?SigninforadditionalsupportoptionstoquicklysolveyourissueSignintrueStructureddatamarkupSupportedstructureddataattributesandvaluesAboutstructureddatamarkupforMerchantCenterSetupstructureddataforMerchantCenterSearchClearsearchClosesearchGoogleappsMainmenuSearchHelpCentertrue71525false