Product - Schema.org Type

Schema.org Type: Product - Any offered product or service. For example: a pair of shoes; a concert ticket; the rental of a car; a haircut; or an episode of ... Schema.org Docs Schemas Validate About Note:youareviewingthedevelopment versionofSchema.org. SeeHowweworkformoredetails. Product ASchema.orgType Thing > Product [more...] CanonicalURL:https://schema.org/Product Checkforopenissues. Anyofferedproductorservice.Forexample:apairofshoes;aconcertticket;therentalofacar;ahaircut;oranepisodeofaTVshowstreamedonline. PropertyExpectedTypeDescription Propertiesfrom Product additionalProperty PropertyValue Aproperty-valuepairrepresentinganadditionalcharacteristicsoftheentitity,e.g.aproductfeatureoranothercharacteristicforwhichthereisnomatchingpropertyinschema.org. Note:Publishersshouldbeawarethatapplicationsdesignedtousespecificschema.orgproperties(e.g.https://schema.org/width,https://schema.org/color,https://schema.org/gtin13,...)willtypicallyexpectsuchdatatobeprovidedusingthoseproperties,ratherthanusingthegenericproperty/valuemechanism. aggregateRating AggregateRating Theoverallrating,basedonacollectionofreviewsorratings,oftheitem. audience Audience Anintendedaudience,i.e.agroupforwhomsomethingwascreated. Supersedes serviceAudience. award Text Anawardwonbyorforthisitem. Supersedes awards. brand Brand or Organization Thebrand(s)associatedwithaproductorservice,orthebrand(s)maintainedbyanorganizationorbusinessperson. category CategoryCode or PhysicalActivityCategory or Text or Thing or URL Acategoryfortheitem.Greatersignsorslashescanbeusedtoinformallyindicateacategoryhierarchy. color Text Thecoloroftheproduct. countryOfAssembly Text Theplacewheretheproductwasassembled. countryOfLastProcessing Text Theplacewheretheitem(typicallyProduct)waslastprocessedandtestedbeforeimportation. countryOfOrigin Country Thecountryoforiginofsomething,includingproductsaswellascreativeworkssuchasmovieandTVcontent. InthecaseofTVandmovie,thiswouldbethecountryoftheprincipleofficesoftheproductioncompanyorindividualresponsibleforthemovie.ForotherkindsofCreativeWorkitisdifficulttoprovidefullygeneralguidance,andpropertiessuchascontentLocationandlocationCreatedmaybemoreapplicable. Inthecaseofproducts,thecountryoforiginoftheproduct.Theexactinterpretationofthismayvarybycontextandproducttype,andcannotbefullyenumeratedhere. depth Distance or QuantitativeValue Thedepthoftheitem. funding Grant AGrantthatdirectlyorindirectlyprovidefundingorsponsorshipforthisitem.SeealsoownershipFundingInfo. Inverseproperty: fundedItem gtin Text AGlobalTradeItemNumber(GTIN).GTINsidentifytradeitems,includingproductsandservices,usingnumericidentificationcodes.Thegtinpropertygeneralizestheearliergtin8,gtin12,gtin13,andgtin14properties.TheGS1digitallinkspecificationsexpressGTINsasURLs.AcorrectgtinvalueshouldbeavalidGTIN,whichmeansthatitshouldbeanall-numericstringofeither8,12,13or14digits,ora"GS1DigitalLink"URLbasedonsuchastring.ThenumericcomponentshouldalsohaveavalidGS1checkdigitandmeettheotherrulesforvalidGTINs.SeealsoGS1'sGTINSummaryandWikipediaformoredetails.Left-paddingofthegtinvaluesisnotrequiredorencouraged. gtin12 Text TheGTIN-12codeoftheproduct,ortheproducttowhichtheofferrefers.TheGTIN-12isthe12-digitGS1IdentificationKeycomposedofaU.P.C.CompanyPrefix,ItemReference,andCheckDigitusedtoidentifytradeitems.SeeGS1GTINSummaryformoredetails. gtin13 Text TheGTIN-13codeoftheproduct,ortheproducttowhichtheofferrefers.Thisisequivalentto13-digitISBNcodesandEANUCC-13.Former12-digitUPCcodescanbeconvertedintoaGTIN-13codebysimplyaddingaprecedingzero.SeeGS1GTINSummaryformoredetails. gtin14 Text TheGTIN-14codeoftheproduct,ortheproducttowhichtheofferrefers.SeeGS1GTINSummaryformoredetails. gtin8 Text TheGTIN-8codeoftheproduct,ortheproducttowhichtheofferrefers.ThiscodeisalsoknownasEAN/UCC-8or8-digitEAN.SeeGS1GTINSummaryformoredetails. hasAdultConsideration AdultOrientedEnumeration Usedtotaganitemtobeintendedorsuitableforconsumptionorusebyadultsonly. hasEnergyConsumptionDetails EnergyConsumptionDetails DefinestheenergyefficiencyCategory(alsoknownas"class"or"rating")foraproductaccordingtoaninternationalenergyefficiencystandard. hasMeasurement QuantitativeValue Aproductmeasurement,forexampletheinseamofpants,thewheelsizeofabicycle,orthegaugeofascrew.Usuallyanexactmeasurement,butcanalsobearangeofmeasurementsforadjustableproducts,forexamplebeltsandskibindings. hasMerchantReturnPolicy MerchantReturnPolicy SpecifiesaMerchantReturnPolicythatmaybeapplicable. Supersedes hasProductReturnPolicy. height Distance or QuantitativeValue Theheightoftheitem. inProductGroupWithID Text IndicatestheproductGroupIDforaProductGroupthatthisproductisVariantOf. isAccessoryOrSparePartFor Product Apointertoanotherproduct(ormultipleproducts)forwhichthisproductisanaccessoryorsparepart. isConsumableFor Product Apointertoanotherproduct(ormultipleproducts)forwhichthisproductisaconsumable. isFamilyFriendly Boolean Indicateswhetherthiscontentisfamilyfriendly. isRelatedTo Product or Service Apointertoanother,somehowrelatedproduct(ormultipleproducts). isSimilarTo Product or Service Apointertoanother,functionallysimilarproduct(ormultipleproducts). isVariantOf ProductGroup or ProductModel Indicatesthekindofproductthatthisisavariantof.InthecaseofProductModel,thisisapointer(fromaProductModel)toabaseproductfromwhichthisproductisavariant.Itissafetoinferthatthevariantinheritsallproductfeaturesfromthebasemodel,unlessdefinedlocally.Thisisnottransitive.InthecaseofaProductGroup,thegroupdescriptionalsoservesasatemplate,representingasetofProductsthatvaryonexplicitlydefined,specificdimensionsonly(soitdefinesbothasetofvariants,aswellaswhichvaluesdistinguishamongstthosevariants).WhenusedwithProductGroup,thispropertycanapplytoanyProductincludedinthegroup. Inverseproperty: hasVariant itemCondition OfferItemCondition ApredefinedvaluefromOfferItemConditionspecifyingtheconditionoftheproductorservice,ortheproductsorservicesincludedintheoffer.Alsousedforproductreturnpoliciestospecifytheconditionofproductsacceptedforreturns. keywords DefinedTerm or Text or URL Keywordsortagsusedtodescribesomeitem.Multipletextualentriesinakeywordslistaretypicallydelimitedbycommas,orbyrepeatingtheproperty. logo ImageObject or URL Anassociatedlogo. manufacturer Organization Themanufactureroftheproduct. material Product or Text or URL Amaterialthatsomethingismadefrom,e.g.leather,wool,cotton,paper. model ProductModel or Text Themodeloftheproduct.UsewiththeURLofaProductModeloratextualrepresentationofthemodelidentifier.TheURLoftheProductModelcanbefromanexternalsource.Itisrecommendedtoadditionallyprovidestrongproductidentifiersviathegtin8/gtin13/gtin14andmpnproperties. mpn Text TheManufacturerPartNumber(MPN)oftheproduct,ortheproducttowhichtheofferrefers. nsn Text IndicatestheNATOstocknumber(nsn)ofaProduct. offers Demand or Offer Anoffertoprovidethisitem—forexample,anoffertosellaproduct,renttheDVDofamovie,performaservice,orgiveawayticketstoanevent.UsebusinessFunctiontoindicatethekindoftransactionoffered,i.e.sell,lease,etc.ThispropertycanalsobeusedtodescribeaDemand.Whilethispropertyislistedasexpectedonanumberofcommontypes,itcanbeusedinothers.Inthatcase,usingasecondtype,suchasProductorasubtypeofProduct,canclarifythenatureoftheoffer. Inverseproperty: itemOffered pattern DefinedTerm or Text Apatternthatsomethinghas,forexample'polkadot','striped','Canadianflag'.Valuesaretypicallyexpressedastext,althoughlinkstocontrolledvalueschemesarealsosupported. productID Text Theproductidentifier,suchasISBN.Forexample:metaitemprop="productID"content="isbn:123-456-789". productionDate Date Thedateofproductionoftheitem,e.g.vehicle. purchaseDate Date Thedatetheiteme.g.vehiclewaspurchasedbythecurrentowner. releaseDate Date Thereleasedateofaproductorproductmodel.Thiscanbeusedtodistinguishtheexactvariantofaproduct. review Review Areviewoftheitem. Supersedes reviews. size DefinedTerm or QuantitativeValue or SizeSpecification or Text Astandardizedsizeofaproductorcreativework,specifiedeitherthroughasimpletextualstring(forexample'XL','32Wx34L'),aQuantitativeValuewithaunitCode,oracomprehensiveandstructuredSizeSpecification;inothercases,thewidth,height,depthandweightpropertiesmaybemoreapplicable. sku Text TheStockKeepingUnit(SKU),i.e.amerchant-specificidentifierforaproductorservice,ortheproducttowhichtheofferrefers. slogan Text Asloganormottoassociatedwiththeitem. weight QuantitativeValue Theweightoftheproductorperson. width Distance or QuantitativeValue Thewidthoftheitem. Propertiesfrom Thing additionalType URL Anadditionaltypefortheitem,typicallyusedforaddingmorespecifictypesfromexternalvocabulariesinmicrodatasyntax.Thisisarelationshipbetweensomethingandaclassthatthethingisin.InRDFasyntax,itisbettertousethenativeRDFasyntax-the'typeof'attribute-formultipletypes.Schema.orgtoolsmayhaveonlyweakerunderstandingofextratypes,inparticularthosedefinedexternally. alternateName Text Analiasfortheitem. description Text Adescriptionoftheitem. disambiguatingDescription Text Asubpropertyofdescription.Ashortdescriptionoftheitemusedtodisambiguatefromother,similaritems.Informationfromotherproperties(inparticular,name)maybenecessaryforthedescriptiontobeusefulfordisambiguation. identifier PropertyValue or Text or URL TheidentifierpropertyrepresentsanykindofidentifierforanykindofThing,suchasISBNs,GTINcodes,UUIDsetc.Schema.orgprovidesdedicatedpropertiesforrepresentingmanyofthese,eitherastextualstringsorasURL(URI)links.Seebackgroundnotesformoredetails. image ImageObject or URL Animageoftheitem.ThiscanbeaURLorafullydescribedImageObject. mainEntityOfPage CreativeWork or URL Indicatesapage(orotherCreativeWork)forwhichthisthingisthemainentitybeingdescribed.Seebackgroundnotesfordetails. Inverseproperty: mainEntity name Text Thenameoftheitem. potentialAction Action IndicatesapotentialAction,whichdescribesanidealizedactioninwhichthisthingwouldplayan'object'role. sameAs URL URLofareferenceWebpagethatunambiguouslyindicatestheitem'sidentity.E.g.theURLoftheitem'sWikipediapage,Wikidataentry,orofficialwebsite. subjectOf CreativeWork or Event ACreativeWorkorEventaboutthisThing. Inverseproperty: about url URL URLoftheitem. Instancesof Productmayappearasavalueforthefollowingproperties PropertyOnTypesDescription fundedItem Grant IndicatessomethingdirectlyorindirectlyfundedorsponsoredthroughaGrant.SeealsoownershipFundingInfo. hasVariant ProductGroup IndicatesaProductthatisamemberofthisProductGroup(orProductModel). isAccessoryOrSparePartFor Product Apointertoanotherproduct(ormultipleproducts)forwhichthisproductisanaccessoryorsparepart. isBasedOn CreativeWork Aresourcefromwhichthisworkisderivedorfromwhichitisamodificationoradaption. isBasedOnUrl CreativeWork Aresourcethatwasusedinthecreationofthisresource.Thistermcanberepeatedformultiplesources.Forexample,http://example.com/great-multiplication-intro.html. isConsumableFor Product Apointertoanotherproduct(ormultipleproducts)forwhichthisproductisaconsumable. isRelatedTo Product or Service Apointertoanother,somehowrelatedproduct(ormultipleproducts). isSimilarTo Product or Service Apointertoanother,functionallysimilarproduct(ormultipleproducts). itemOffered Demand or Offer Anitembeingoffered(ordemanded).ThetransactionalnatureoftheofferordemandisdocumentedusingbusinessFunction,e.g.sell,leaseetc.Whileseveralcommonexpectedtypesarelistedexplicitlyinthisdefinition,otherscanbeused.Usingasecondtype,suchasProductorasubtypeofProduct,canclarifythenatureoftheoffer. itemShipped ParcelDelivery Item(s)beingshipped. material CreativeWork or Product Amaterialthatsomethingismadefrom,e.g.leather,wool,cotton,paper. orderedItem Order or OrderItem Theitemordered. owns Organization or Person Productsownedbytheorganizationorperson. productSupported ContactPoint Theproductorservicethissupportcontactpointisrelatedto(suchasproductsupportforaparticularproductline).Thiscanbeaspecificproductorproductline(e.g."iPhone")orageneralcategoryofproductsorservices(e.g."smartphones"). typeOfGood OwnershipInfo or TypeAndQuantityNode Theproductthatthisstructuredvalueisreferringto. MorespecificTypes IndividualProduct ProductCollection ProductGroup ProductModel SomeProducts Vehicle Acknowledgements ThistermusesterminologyfromtheGoodRelationsVocabularyforE-Commerce,createdbyMartinHepp.GoodRelationsisadatamodelforsharinge-commercedataontheWeb.MoreinformationaboutGoodRelationscanbefoundathttp://purl.org/goodrelations/. Examples Example1 Copied NoMarkup Microdata RDFa JSON-LD Structure ExamplenotesorexampleHTMLwithoutmarkup. KenmoreWhite17"Microwave Rated3.5/5basedon11customerreviews $55.00 Instock Productdescription: 0.7cubicfeetcountertopmicrowave.Hassixpresetcookingcategoriesand conveniencefeatureslikeAdd-A-MinuteandChildLock. Customerreviews: Notahappycamper-byEllie,April1,2011 1/5stars ThelampburnedoutandnowIhavetoreplaceit. Valuepurchase-byLucas,March25,2011 4/5stars Greatmicrowavefortheprice.Itissmallandfitsinmyapartment. ... ExampleencodedasMicrodataembeddedinHTML. KenmoreWhite17"Microwave Rated3.5/5 basedon11customerreviews $1,000.00 Instock Productdescription: 0.7cubicfeetcountertopmicrowave. Hassixpresetcookingcategoriesandconveniencefeatureslike Add-A-MinuteandChildLock. Customerreviews: Notahappycamper- byEllie, April1,2011 1/ 5stars ThelampburnedoutandnowIhavetoreplace it. Valuepurchase- byLucas, March25,2011 4/ 5stars Greatmicrowavefortheprice.Itissmalland fitsinmyapartment. ... ExampleencodedasRDFaembeddedinHTML. KenmoreWhite17"Microwave Rated3.5/5 basedon11customerreviews $1,000.00 Instock Productdescription: 0.7cubicfeetcountertopmicrowave. Hassixpresetcookingcategoriesandconveniencefeatureslike Add-A-MinuteandChildLock. Customerreviews: Notahappycamper- byEllie, April1,2011 1/ 5stars ThelampburnedoutandnowIhavetoreplace it. Valuepurchase- byLucas, March25,2011 4/ 5stars Greatmicrowavefortheprice.Itissmalland fitsinmyapartment. ... ExampleencodedasJSON-LDinaHTMLscripttag. { "@context":"https://schema.org", "@type":"Product", "aggregateRating":{ "@type":"AggregateRating", "ratingValue":"3.5", "reviewCount":"11" }, "description":"0.7cubicfeetcountertopmicrowave.HassixpresetcookingcategoriesandconveniencefeatureslikeAdd-A-MinuteandChildLock.", "name":"KenmoreWhite17\"Microwave", "image":"kenmore-microwave-17in.jpg", "offers":{ "@type":"Offer", "availability":"https://schema.org/InStock", "price":"55.00", "priceCurrency":"USD" }, "review":[ { "@type":"Review", "author":"Ellie", "datePublished":"2011-04-01", "reviewBody":"ThelampburnedoutandnowIhavetoreplaceit.", "name":"Notahappycamper", "reviewRating":{ "@type":"Rating", "bestRating":"5", "ratingValue":"1", "worstRating":"1" } }, { "@type":"Review", "author":"Lucas", "datePublished":"2011-03-25", "reviewBody":"Greatmicrowavefortheprice.Itissmallandfitsinmyapartment.", "name":"Valuepurchase", "reviewRating":{ "@type":"Rating", "bestRating":"5", "ratingValue":"4", "worstRating":"1" } } ] } StructuredrepresentationoftheJSON-LDexample. { "@context":"https://schema.org", "@type":"Product", "aggregateRating":{ "@type":"AggregateRating", "ratingValue":"3.5", "reviewCount":"11" }, "description":"0.7cubicfeetcountertopmicrowave.HassixpresetcookingcategoriesandconveniencefeatureslikeAdd-A-MinuteandChildLock.", "name":"KenmoreWhite17\"Microwave", "image":"kenmore-microwave-17in.jpg", "offers":{ "@type":"Offer", "availability":"https://schema.org/InStock", "price":"55.00", "priceCurrency":"USD" }, "review":[ { "@type":"Review", "author":"Ellie", "datePublished":"2011-04-01", "reviewBody":"ThelampburnedoutandnowIhavetoreplaceit.", "name":"Notahappycamper", "reviewRating":{ "@type":"Rating", "bestRating":"5", "ratingValue":"1", "worstRating":"1" } }, { "@type":"Review", "author":"Lucas", "datePublished":"2011-03-25", "reviewBody":"Greatmicrowavefortheprice.Itissmallandfitsinmyapartment.", "name":"Valuepurchase", "reviewRating":{ "@type":"Rating", "bestRating":"5", "ratingValue":"4", "worstRating":"1" } } ] } Example2 Copied NoMarkup Microdata RDFa JSON-LD Structure ExamplenotesorexampleHTMLwithoutmarkup. DellUltraSharp30"LCDMonitor 87outof100basedon24userratings $1250to$1495from8sellers Sellers: SaveALotMonitors-$1250 JonDoe'sGadgets-$1350 ... ExampleencodedasMicrodataembeddedinHTML. DellUltraSharp30"LCDMonitor 87 outof100 basedon24userratings $1250 to$1495 from8sellers Sellers: SaveALotMonitors-$1250 JonDoe'sGadgets-$1350 ... ExampleencodedasRDFaembeddedinHTML. DellUltraSharp30"LCDMonitor 87outof 100basedon 24userratings $1250to $1495from 8sellersSellers: SaveALotMonitors-$1250 JonDoe'sGadgets-$1350 ... ExampleencodedasJSON-LDinaHTMLscripttag. { "@context":"https://schema.org", "@type":"Product", "aggregateRating":{ "@type":"AggregateRating", "bestRating":"100", "ratingCount":"24", "ratingValue":"87" }, "image":"dell-30in-lcd.jpg", "name":"DellUltraSharp30\"LCDMonitor", "offers":{ "@type":"AggregateOffer", "highPrice":"$1495", "lowPrice":"$1250", "offerCount":"8", "offers":[ { "@type":"Offer", "url":"save-a-lot-monitors.com/dell-30.html" }, { "@type":"Offer", "url":"jondoe-gadgets.com/dell-30.html" } ] } } StructuredrepresentationoftheJSON-LDexample. { "@context":"https://schema.org", "@type":"Product", "aggregateRating":{ "@type":"AggregateRating", "bestRating":"100", "ratingCount":"24", "ratingValue":"87" }, "image":"dell-30in-lcd.jpg", "name":"DellUltraSharp30\"LCDMonitor", "offers":{ "@type":"AggregateOffer", "highPrice":"$1495", "lowPrice":"$1250", "offerCount":"8", "offers":[ { "@type":"Offer", "url":"save-a-lot-monitors.com/dell-30.html" }, { "@type":"Offer", "url":"jondoe-gadgets.com/dell-30.html" } ] } } Example3 Copied NoMarkup Microdata RDFa JSON-LD Structure ExamplenotesorexampleHTMLwithoutmarkup.