AggregateOffer

schema:Thing > schema:Intangible > schema:Offer > schema:AggregateOffer

When a single product is associated with multiple offers (for example, the same pair of shoes is offered by different merchants), then AggregateOffer can be used.
PropertyExpected TypeDescription
Properties from schema:AggregateOffer
schema:highPrice schema:Number  or
schema:Text 
The highest price of all offers available.
schema:lowPrice schema:Number  or
schema:Text 
The lowest price of all offers available.
schema:offerCount schema:Integer The number of offers for the product.
schema:offers schema:Offer An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, or give away tickets to an event.
Properties from schema:Offer
schema:acceptedPaymentMethod schema:PaymentMethod The payment method(s) accepted by seller for this offer.
schema:addOn schema: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).
schema:advanceBookingRequirement schema:QuantitativeValue The amount of time that is required between accepting the offer and the actual usage of the resource or service.
schema:aggregateRating schema:AggregateRating The overall rating, based on a collection of reviews or ratings, of the item.
schema:availability schema:ItemAvailability The availability of this item—for example In stock, Out of stock, Pre-order, etc.
schema:availabilityEnds schema:DateTime The end of the availability of the product or service included in the offer.
schema:availabilityStarts schema:DateTime The beginning of the availability of the product or service included in the offer.
schema:availableAtOrFrom schema:Place The place(s) from which the offer can be obtained (e.g. store locations).
schema:availableDeliveryMethod schema:DeliveryMethod The delivery method(s) available for this offer.
schema:businessFunction schema: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.
schema:category schema:Thing  or
schema:PhysicalActivityCategory  or
schema:Text 
A category for the item. Greater signs or slashes can be used to informally indicate a category hierarchy.
schema:deliveryLeadTime schema:QuantitativeValue The typical delay between the receipt of the order and the goods leaving the warehouse.
schema:eligibleCustomerType schema:BusinessEntityType The type(s) of customers for which the given offer is valid.
schema:eligibleDuration schema:QuantitativeValue The duration for which the given offer is valid.
schema:eligibleQuantity schema: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.
schema:eligibleRegion schema:GeoShape  or
schema: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.
schema:eligibleTransactionVolume schema: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.
schema:gtin13 schema: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. See GS1 GTIN Summary for more details.
schema:gtin14 schema:Text The GTIN-14 code of the product, or the product to which the offer refers. See GS1 GTIN Summary for more details.
schema:gtin8 schema: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.
schema:includesObject schema:TypeAndQuantityNode This links to a node or nodes indicating the exact quantity of the products included in the offer.
schema:ineligibleRegion schema:Place The place(s) from which the offer cannot be obtained (e.g. a region where the transaction is not allowed).
schema:inventoryLevel schema:QuantitativeValue The current approximate inventory level for the item or items.
schema:itemCondition schema: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.
schema:itemOffered schema:Product The item being offered.
schema:mpn schema:Text The Manufacturer Part Number (MPN) of the product, or the product to which the offer refers.
schema:price schema:Number  or
schema:Text 
The offer price of a product, or of a price component when attached to PriceSpecification and its subtypes.

Usage guidelines:
  • Use the priceCurrency property (with ISO 4217 codes e.g. "USD") instead of including ambiguous symbols such as '$' in the value.
  • Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.
  • Note that both RDFa and Microdata syntax allow the use of a "content=" attribute for publishing simple machine-readable values alongside more human-friendly formatting.
  • Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similiar Unicode symbols.
schema:priceCurrency schema:Text The currency (in 3-letter ISO 4217 format) of the price or a price component, when attached to PriceSpecification and its subtypes.
schema:priceSpecification schema:PriceSpecification One or more detailed price specifications, indicating the unit price and delivery or payment charges.
schema:priceValidUntil schema:Date The date after which the price is no longer available.
schema:review schema:Review A review of the item. Supersedes schema:reviews.
schema:seller schema:Person  or
schema:Organization 
An entity which offers (sells / leases / lends / loans) the services / goods. A seller may also be a provider. Supersedes schema:merchant, schema:vendor.
schema:serialNumber schema: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.
schema:sku schema: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.
schema:validFrom schema:DateTime The date when the item becomes valid.
schema:validThrough schema:DateTime The end of the validity of offer, price specification, or opening hours data.
schema:warranty schema:WarrantyPromise The warranty promise(s) included in the offer.
Properties from schema:Thing
schema:additionalType schema: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.
schema:alternateName schema:Text An alias for the item.
schema:description schema:Text A short description of the item.
schema:image schema:URL  or
schema:ImageObject 
An image of the item. This can be a URL or a fully described ImageObject.
schema:name schema:Text The name of the item.
schema:potentialAction schema:Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
schema:sameAs schema:URL URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.
schema:url schema:URL URL of the item.

Prefixes used:

  • schema: http://schema.org/
  • Examples

    <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
    
    <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>
    
    <div vocab="http://schema.org/" typeof="Event">
      <a property="url" href="nba-miami-philidelphia-game3.html">
      NBA Eastern Conference First Round Playoff Tickets:
      <span property="name"> Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) </span>
      </a>
      <meta property="startDate" content="2016-04-21T20:00">
        Thu, 04/21/16
        8:00 p.m.
      <div property="location"  typeof="Place">
        <a property="url" href="wells-fargo-center.html">
        Wells Fargo Center
        </a>
        <div property="address"  typeof="PostalAddress">
          <span property="addressLocality">Philadelphia</span>,
          <span property="addressRegion">PA</span>
        </div>
      </div>
      <div property="offers"  typeof="AggregateOffer">
        Priced from: <span property="lowPrice">$35</span>
        <span property="offerCount">1938</span> tickets left
      </div>
    </div>
    
    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "Event",
      "name": "Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1)",
      "location": {
        "@type": "Place",
        "address": {
          "@type": "PostalAddress",
          "addressLocality": "Philadelphia",
          "addressRegion": "PA"
        },
        "url": "wells-fargo-center.html"
      },
      "offers": {
        "@type": "AggregateOffer",
        "lowPrice": "$35",
        "offerCount": "1938"
      },
      "startDate": "2016-04-21T20:00",
      "url": "nba-miami-philidelphia-game3.html"
    }
    </script>
    
    <img src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor" />
    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>
    ...
    
    <div itemscope itemtype="http://schema.org/Product">
      <img itemprop="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
      <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>
      ...
    </div>
    
    <div vocab="http://schema.org/" typeof="Product">
      <img property="image" src="dell-30in-lcd.jpg" alt="A Dell UltraSharp monitor"/>
      <span property="name">Dell UltraSharp 30" LCD Monitor</span>
      <div property="aggregateRating"
         typeof="AggregateRating">
        <span property="ratingValue">87</span>
        out of <span property="bestRating">100</span>
        based on <span property="ratingCount">24</span> user ratings
      </div>
      <div property="offers"  typeof="AggregateOffer">
        <span property="lowPrice">$1250</span>
        to <span property="highPrice">$1495</span>
        from <span property="offerCount">8</span> sellers
      Sellers:
      <div property="offers"  typeof="Offer">
        <a property="url" href="save-a-lot-monitors.com/dell-30.html">
         Save A Lot Monitors - $1250</a>
      </div>
      <div property="offers"  typeof="Offer">
        <a property="url" href="jondoe-gadgets.com/dell-30.html">
         Jon Doe's Gadgets - $1350</a>
      </div>
      ...
    </div>
    
    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "Product",
      "aggregateRating": {
        "@type": "AggregateRating",
        "bestRating": "100",
        "ratingCount": "24",
        "ratingValue": "87"
      },
      "image": "dell-30in-lcd.jpg",
      "name": "Dell UltraSharp 30\" LCD Monitor",
      "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"
          }
        ]
      }
    }
    </script>
    

    Schema.org Version 1.93
    BiblioGraph.net Version 1.1
    Code Version 1.1