Note: you are viewing the development version of See How we work for more details.


A Type
A placeholder for multiple similar products of the same kind.
PropertyExpected TypeDescription
Properties from SomeProducts
inventoryLevel QuantitativeValue The current approximate inventory level for the item or items.
Properties from Product
additionalProperty PropertyValue A property-value pair representing an additional characteristics of the entitity, e.g. a product feature or another characteristic for which there is no matching property in

Note: Publishers should be aware that applications designed to use specific properties (e.g.,,, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism.
aggregateRating AggregateRating The overall rating, based on a collection of reviews or ratings, of the item.
audience Audience An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience.
award Text An award won by or for this item. Supersedes awards.
brand Brand  or
The brand(s) associated with a product or service, or the brand(s) maintained by an organization or business person.
category PhysicalActivityCategory  or
Text  or
Thing  or
A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.
color Text The color of the product.
depth Distance  or
The depth of the item.
gtin Text A Global Trade Item Number (GTIN). GTINs identify trade items, including products and services, using numeric identification codes. The gtin property generalizes the earlier gtin8, gtin12, gtin13, and gtin14 properties. The GS1 digital link specifications express GTINs as URLs. A correct gtin value should be a valid GTIN, which means that it should be an all-numeric string of either 8, 12, 13 or 14 digits, or a "GS1 Digital Link" URL based on such a string. The numeric component should also have a valid GS1 check digit and meet the other rules for valid GTINs. See also GS1's GTIN Summary and Wikipedia for more details. Left-padding of the gtin values is not required or encouraged.
gtin12 Text The GTIN-12 code of the product, or the product to which the offer refers. The GTIN-12 is the 12-digit GS1 Identification Key composed of a U.P.C. Company Prefix, Item Reference, and Check Digit used to identify trade items. See GS1 GTIN Summary for more details.
gtin13 Text The GTIN-13 code of the product, or the product to which the offer refers. This is equivalent to 13-digit ISBN codes and EAN UCC-13. Former 12-digit UPC codes can be converted into a GTIN-13 code by simply adding a preceding zero. See GS1 GTIN Summary for more details.
gtin14 Text The GTIN-14 code of the product, or the product to which the offer refers. See GS1 GTIN Summary for more details.
gtin8 Text The GTIN-8 code of the product, or the product to which the offer refers. This code is also known as EAN/UCC-8 or 8-digit EAN. See GS1 GTIN Summary for more details.
hasEnergyConsumptionDetails EnergyConsumptionDetails Defines the energy efficiency Category (also known as "class" or "rating") for a product according to an international energy efficiency standard.
hasMeasurement QuantitativeValue A product measurement, for example the inseam of pants, the wheel size of a bicycle, or the gauge of a screw. Usually an exact measurement, but can also be a range of measurements for adjustable products, for example belts and ski bindings.
hasMerchantReturnPolicy MerchantReturnPolicy Indicates a MerchantReturnPolicy that may be applicable. Supersedes hasProductReturnPolicy.
height Distance  or
The height of the item.
inProductGroupWithID Text Indicates the productGroupID for a ProductGroup that this product isVariantOf.
isAccessoryOrSparePartFor Product A pointer to another product (or multiple products) for which this product is an accessory or spare part.
isConsumableFor Product A pointer to another product (or multiple products) for which this product is a consumable.
isRelatedTo Product  or
A pointer to another, somehow related product (or multiple products).
isSimilarTo Product  or
A pointer to another, functionally similar product (or multiple products).
isVariantOf ProductGroup  or
Indicates the kind of product that this is a variant of. In the case of ProductModel, this is a pointer (from a ProductModel) to a base product from which this product is a variant. It is safe to infer that the variant inherits all product features from the base model, unless defined locally. This is not transitive. In the case of a ProductGroup, the group description also serves as a template, representing a set of Products that vary on explicitly defined, specific dimensions only (so it defines both a set of variants, as well as which values distinguish amongst those variants). When used with ProductGroup, this property can apply to any Product included in the group.
Inverse property: hasVariant
itemCondition OfferItemCondition A predefined value from OfferItemCondition or a textual description of the condition of the product or service, or the products or services included in the offer.
logo ImageObject  or
An associated logo.
manufacturer Organization The manufacturer of the product.
material Product  or
Text  or
A material that something is made from, e.g. leather, wool, cotton, paper.
model ProductModel  or
The model of the product. Use with the URL of a ProductModel or a textual representation of the model identifier. The URL of the ProductModel can be from an external source. It is recommended to additionally provide strong product identifiers via the gtin8/gtin13/gtin14 and mpn properties.
mpn Text The Manufacturer Part Number (MPN) of the product, or the product to which the offer refers.
nsn Text Indicates the NATO stock number (nsn) of a Product.
offers Demand  or
An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event. Use businessFunction to indicate the kind of transaction offered, i.e. sell, lease, etc. This property can also be used to describe a Demand. While this property is listed as expected on a number of common types, it can be used in others. In that case, using a second type, such as Product or a subtype of Product, can clarify the nature of the offer.
Inverse property: itemOffered
pattern DefinedTerm  or
A pattern that something has, for example 'polka dot', 'striped', 'Canadian flag'. Values are typically expressed as text, although links to controlled value schemes are also supported.
productID Text The product identifier, such as ISBN. For example: meta itemprop="productID" content="isbn:123-456-789".
productionDate Date The date of production of the item, e.g. vehicle.
purchaseDate Date The date the item e.g. vehicle was purchased by the current owner.
releaseDate Date The release date of a product or product model. This can be used to distinguish the exact variant of a product.
review Review A review of the item. Supersedes reviews.
size DefinedTerm  or
QuantitativeValue  or
SizeSpecification  or
A standardized size of a product or creative work, specified either through a simple textual string (for example 'XL', '32Wx34L'), a QuantitativeValue with a unitCode, or a comprehensive and structured SizeSpecification; in other cases, the width, height, depth and weight properties may be more applicable.
sku Text The Stock Keeping Unit (SKU), i.e. a merchant-specific identifier for a product or service, or the product to which the offer refers.
slogan Text A slogan or motto associated with the item.
weight QuantitativeValue The weight of the product or person.
width Distance  or
The width of the item.
Properties from Thing
additionalType URL An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. tools may have only weaker understanding of extra types, in particular those defined externally.
alternateName Text An alias for the item.
description Text A description of the item.
disambiguatingDescription Text A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
identifier PropertyValue  or
Text  or
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.
image ImageObject  or
An image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPage CreativeWork  or
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity
name Text The name of the item.
potentialAction Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
sameAs URL URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
subjectOf CreativeWork  or
A CreativeWork or Event about this Thing.
Inverse property: about
url URL URL of the item.


This class is derived from the GoodRelations Vocabulary for E-Commerce, created by Martin Hepp. GoodRelations is a data model for sharing e-commerce data on the Web that can be expressed in a variety of syntaxes, including RDFa and HTML5 Microdata. More information about GoodRelations can be found at


Example 1
Example notes or example HTML without markup.
We have the Brother HL-2230 on sale! Brother HL-2230 Compact Laser
Printer. A fast, great-looking, compact laser printer for your
desk. GTIN13: 0012502627104
Example encoded as Microdata embedded in HTML.
The SomeProducts type is used when the product is an item drawn from a
collection of interchangeably similar items.

<div itemscope itemtype="" itemid="#product">
 We have the Brother HL-2230 on sale!
 <span itemprop="name">Brother HL-2230 Compact Laser Printer</span>
 <link itemprop="additionalType"
       href="" />
 <span itemprop="description">A fast, great-looking, compact laser
  printer for your desk.</span>
 GTIN13: <span itemprop="gtin13">0012502627104</span>
Example encoded as RDFa embedded in HTML.
The SomeProducts type is used when the product is an item drawn from a
collection of interchangeably similar items.

<div  typeof="SomeProducts" resource="#product">
 We have the Brother HL-2230 on sale!
 <span property="name">Brother HL-2230 Compact Laser Printer</span>
 <link property="additionalType"
       href="" />
 <span property="description">A fast, great-looking, compact laser
  printer for your desk.</span>
 GTIN13: <span property="gtin13">0012502627104</span>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">
  "@context": "",
  "@id": "#product",
  "@type": "SomeProducts",
  "additionalType": "",
  "description": "A fast, great-looking, compact laser printer for your desk.",
  "gtin13": "0012502627104",
  "name": "Brother HL-2230 Compact Laser Printer"
Structured representation of the JSON-LD example.