Product schema

type #

type

@type

Type of the product. Multiple types can be selected.

type wiki

additionalType

Wikipedia terms that describe the type of this product more accurately.

More about this field here.

info #

name

required

name

The name of the product.

model

model

The model of the product. Use with the URL of a ProductModel or a textual representation of the model identifier. It is recommended to additionally provide strong product identifiers via the gtin8/gtin13/gtin14 and mpn properties.

sku

recommended for Merchant listings

sku

The Stock Keeping Unit (SKU), i.e. a merchant-specific identifier for a product.

gtin

recommended for Merchant listings

gtin

A Global Trade Item Number (GTIN). GTINs identify trade items using numeric identification codes.
( gtin8 | gtin12 | gtin13 | gtin14 )

categories

category

Categories for the product.

manufacturer

manufacturer

The manufacturer of the product.

country of assembly

countryOfAssembly

The place where the product was assembled.

description

recommended for Merchant listings

description

A description of the product.

color

recommended for Merchant listings

color

The color or color combination of the product, e.g., “red” or “yellow/sky blue”.

pricing #

availability

availability

One of the following: Back Order, Discontinued, In Stock, In Store Only, Limited Availability, Online Only, Out Of Stock, Pre-Order, Pre-Sale, Sold Out

price

required (or reviews, or rating)

recommended

price

The offer price of the product.

currency

priceCurrency

The currency of the price.

valid until

priceValidUntil

The date after which the price will no longer be available, if applicable. Your product snippet may not display if this property indicates a past date.

seller

seller

A business or person which offers the product.
The merchant has to be the seller of the product in order to be eligible for merchant listing experiences.

url

url

A URL where the product is available at this price.

Merchant Return Policy

recommended for Merchant listings

hasMerchantReturnPolicy

Provides information about product return policies associated with that offer.

country

required

applicableCountry

A country where that particular merchant return policy applies to.

category

required

returnPolicyCategory

return days

merchantReturnDays

The number of days (from the delivery date) that a product can be returned. Used when the category property is specified as MerchantReturnFiniteReturnWindow.

return method

returnMethod

The type of return method offered. Can be one from:

return fees

returnFees

The type of return fees for purchased products (for any return reason). Can be one from:

return fees amount

returnShippingFeesAmount

Amount of shipping costs for product returns (for any reason). Applicable when property return fees equals ReturnShippingFees.

Shipping Details

recommended for Merchant listings

shippingDetails

Enables people to see shipping costs and estimated delivery timeframes based on their location and your company’s shipping policies. To make your products eligible for the shipping details enhancement, add these properties to your product pages.

audience #

audience

recommended for Merchant listings

audience

Optional information about the suggested audience for the product, such as the suggested gender and age group. Only the audiences of PeopleAudience type is supported.

extra #

slogan

slogan

A slogan or motto associated with the product.

brands

recommended for Merchant listings

brand

The brand(s) associated with the product. A brand is a name used by an organization or business person for labeling a product, product group, or similar.

awards

award

Awards won for the product.

Energy Consumption

recommended for Merchant listings

hasEnergyConsumptionDetails

Information about the energy consumption of products such as electrical goods. This property is particularly important in European countries.

Here is an example of this property:

{
  "hasEnergyConsumptionDetails": {
    "@type": "EnergyConsumptionDetails",
    "hasEnergyEfficiencyCategory": "EUEnergyEfficiencyCategoryC",
    "energyEfficiencyScaleMin": "EUEnergyEfficiencyCategoryF",
    "energyEfficiencyScaleMax": "EUEnergyEfficiencyCategoryA1Plus"
  }
}
JSON

The values for energyEfficiencyScaleMin and energyEfficiencyScaleMax are automatically added from Actus Deep Schema when the EU Energy Efficiency standard is selected.

media #

images

required for Merchant listings

image

Images for the product. Pictures clearly showing the product (for example, against a white background) are preferred.

video

video

Videos about the product.

reviews #

reviews

required (or rating, or price)

recommended

review

Detailed reviews and ratings of the item.

name

author

Name of the review author.

published

datePublished

Date of review publication.

description

reviewBody

The review description.

rating

reviewRating

Rating of the item and values of the rating system.

rating

required (or reviews, or price)

recommended

aggregateRating

The overall rating of the item, based on a collection of reviews or ratings.
Best and Worst values indicate the range of the rating system.

average

ratingValue

The overall rating value.

count

ratingCount

The total number of ratings for the item on your site.

best

bestRating

The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed.

worst

worstRating

The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed

pros & cons #

pros

positiveNotes

A list of positive statements about the product.

cons

negativeNotes

A list of negative statements about the product.

  • Currently, only editorial product review pages are eligible for the pros and cons appearance in Search, not merchant product pages or customer product reviews.
  • The pros and cons must be visible to users on the page.

These properties are added to the review array. Here is an example of the schema our plugin generates for Pros & Cons:

{
  "review": [
    {
      "@type": "Review",
      "@author": {
        "@id" : "https://deepschema.org/#pers-wp-1"
      },
      "name" : "My Product review",
      "positiveNotes": {
        "@type": "ItemList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Consistent results"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Still sharp after many uses"
          }
        ]
      }
    }
  ]
}
JSON