Thing > Intangible > Offer > AggregateOffer
When a single product that has different offers (for example, the same pair of shoes is offered by different merchants), then AggregateOffer can be used.| Property | Expected Type | Description |
|---|---|---|
| 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. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally. |
description |
Text | A short description of the item. |
image |
URL | URL of an image of the item. |
name |
Text | The name of the item. |
url |
URL | URL of the item. |
| Properties from Offer | ||
acceptedPaymentMethod |
PaymentMethod | The payment method(s) accepted by seller for this offer. |
addOn |
Offer | An additional offer that can only be obtained in combination with the first base offer (e.g. supplements and extensions that are available for a surcharge). |
advanceBookingRequirement |
QuantitativeValue | The amount of time that is required between accepting the offer and the actual usage of the resource or service. |
aggregateRating |
AggregateRating | The overall rating, based on a collection of reviews or ratings, of the item. |
availability |
ItemAvailability | The availability of this item—for example In stock, Out of stock, Pre-order, etc. |
availabilityEnds |
DateTime | The end of the availability of the product or service included in the offer. |
availabilityStarts |
DateTime | The beginning of the availability of the product or service included in the offer. |
availableAtOrFrom |
Place | The place(s) from which the offer can be obtained (e.g. store locations). |
availableDeliveryMethod |
DeliveryMethod | The delivery method(s) available for this offer. |
businessFunction |
BusinessFunction | The business function (e.g. sell, lease, repair, dispose) of the offer or component of a bundle (TypeAndQuantityNode). The default is http://purl.org/goodrelations/v1#Sell. |
category |
PhysicalActivityCategory or Text or Thing | A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy. |
deliveryLeadTime |
QuantitativeValue | The typical delay between the receipt of the order and the goods leaving the warehouse. |
eligibleCustomerType |
BusinessEntityType | The type(s) of customers for which the given offer is valid. |
eligibleDuration |
QuantitativeValue | The duration for which the given offer is valid. |
eligibleQuantity |
QuantitativeValue | The interval and unit of measurement of ordering quantities for which the offer or price specification is valid. This allows e.g. specifying that a certain freight charge is valid only for a certain quantity. |
eligibleRegion |
GeoShape or Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is valid. |
eligibleTransactionVolume |
PriceSpecification | The transaction volume, in a monetary unit, for which the offer or price specification is valid, e.g. for indicating a minimal purchasing volume, to express free shipping above a certain order volume, or to limit the acceptance of credit cards to purchases to a certain minimal amount. |
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 preceeding zero. |
gtin14 |
Text | The GTIN-14 code of the product, or the product to which the offer refers. |
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. |
includesObject |
TypeAndQuantityNode | This links to a node or nodes indicating the exact quantity of the products included in the offer. |
inventoryLevel |
QuantitativeValue | The current approximate inventory level for the item or items. |
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. |
itemOffered |
Product | The item being sold. |
mpn |
Text | The Manufacturer Part Number (MPN) of the product, or the product to which the offer refers. |
price |
Number or Text | The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes. |
priceCurrency |
Text | The currency (in 3-letter ISO 4217 format) of the offer price or a price component, when attached to PriceSpecification and its subtypes. |
priceSpecification |
PriceSpecification | One or more detailed price specifications, indicating the unit price and delivery or payment charges. |
priceValidUntil |
Date | The date after which the price is no longer available. |
review |
Review | A review of the item. |
reviews |
Review | Review of the item (legacy spelling; see singular form, review). |
seller |
Organization or Person | The seller. |
serialNumber |
Text | The serial number or any alphanumeric identifier of a particular product. When attached to an offer, it is a shortcut for the serial number of the product included in the offer. |
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. |
validFrom |
DateTime | The beginning of the validity of offer, price specification, or opening hours data. |
validThrough |
DateTime | The end of the validity of offer, price specification, or opening hours data. |
warranty |
WarrantyPromise | The warranty promise(s) included in the offer. |
| Properties from AggregateOffer | ||
highPrice |
Number or Text | The highest price of all offers available. |
lowPrice |
Number or Text | The lowest price of all offers available. |
offerCount |
Integer | The number of offers for the product. |
Schema Draft Version 1.0a
Example 1
Original HTML:
<a href="nba-miami-philidelphia-game3.html"> NBA Eastern Conference First Round Playoff Tickets: Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </a> Thu, 04/21/16 8:00 p.m. <a href="wells-fargo-center.html"> Wells Fargo Center </a> Philadelphia, PA Priced from: $35 1938 tickets left
With Microdata:
<div itemscope itemtype="http://schema.org/Event">
<a itemprop="url" href="nba-miami-philidelphia-game3.html">
NBA Eastern Conference First Round Playoff Tickets:
<span itemprop="name"> Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </span>
</a>
<meta itemprop="startDate" content="2016-04-21T20:00">
Thu, 04/21/16
8:00 p.m.
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<a itemprop="url" href="wells-fargo-center.html">
Wells Fargo Center
</a>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<span itemprop="addressLocality">Philadelphia</span>,
<span itemprop="addressRegion">PA</span>
</div>
</div>
<div itemprop="offers" itemscope itemtype="http://schema.org/AggregateOffer">
Priced from: <span itemprop="lowPrice">$35</span>
<span itemprop="offerCount">1938</span> tickets left
</div>
</div>
Example 2
Original HTML:
<img src="dell-30in-lcd.jpg" /> Dell UltraSharp 30" LCD Monitor 87 out of 100 based on 24 user ratings $1250 to $1495 from 8 sellers Sellers: <a href="save-a-lot-monitors.com/dell-30.html"> Save A Lot Monitors - $1250</a> <a href="jondoe-gadgets.com/dell-30.html"> Jon Doe's Gadgets - $1350</a> ...
With Microdata:
<div itemscope itemtype="http://schema.org/Product">
<img itemprop="image" src="dell-30in-lcd.jpg" />
<span itemprop="name">Dell UltraSharp 30" LCD Monitor</span>
<div itemprop="aggregateRating"
itemscope itemtype="http://schema.org/AggregateRating">
<span itemprop="ratingValue">87</span>
out of <span itemprop="bestRating">100</span>
based on <span itemprop="ratingCount">24</span> user ratings
</div>
<div itemprop="offers" itemscope itemtype="http://schema.org/AggregateOffer">
<span itemprop="lowPrice">$1250</span>
to <span itemprop="highPrice">$1495</span>
from <span itemprop="offerCount">8</span> sellers
Sellers:
<div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
<a itemprop="url" href="save-a-lot-monitors.com/dell-30.html">
Save A Lot Monitors - $1250</a>
</div>
<div itemprop="offers" itemscope itemtype="http://schema.org/Offer">
<a itemprop="url" href="jondoe-gadgets.com/dell-30.html">
Jon Doe's Gadgets - $1350</a>
</div>
...
</div>