Schema piece - Offer

Describes an offer for a Product (typically prices, stock availability, etc).

Triggers

  • Should be output when required by a Product piece.

Required properties

A valid Offer must have the following properties.

  • ID: The site's home URL appended by #/schema/offer/{{ID}}, where {{ID}} is a unique identifier.
  • availability: A schema.org URL representing a schema itemAvailability value (e.g., https://schema.org/OutOfStock).
  • price: The price, omitting any currency symbols, and using '.' to indicate a decimal place.
  • priceCurrency: The currency used to describe the product price, in three-letter ISO 4217 format.
  • url: The canonical URL of the page containing the Offer.
  • priceSpecification: A PriceSpecification object, including a price, priceCurrency, and valueAddedTaxIncluded property.

Failure scenarios

If any of the required fields are missing or invalid, the node should not be output.

If the node is not output, any entities which would otherwise have referenced the Offer should remove those references (e.g., when a product references an Offer by ID).

Examples

Minimum criteria

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Offer",
"@id": "https://www.example.com/#/schema/offer/abc123",
"price": "22.00",
"priceValidUntil": "2020-12-31",
"priceSpecification": {
"price": "22.00",
"priceCurrency": "GBP",
"valueAddedTaxIncluded": "false"
},
"priceCurrency": "GBP",
"availability": "http://schema.org/InStock",
"url": "https://www.example.com/example-product-page/",
"seller": {
"@id": "https://www.example.com/#/schema/organization/abc123"
}
}
]
}