AggregateOffer - schema.org

# schema.org

- Documentation
- Schemas
- Home

# AggregateOffer

#### Thing > Intangible > Offer > 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.
Usage: Between 10,000 and 50,000 domains

Property | Expected Type | Description
--- | --- | ---
[more...]

- Leave public feedback on this term 💬
- Check for open issues.
- 'AggregateOffer' is mentioned in layer: core

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.
`offers` | Offer | 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.
Properties from Offer
`acceptedPaymentMethod` | LoanOrCredit or 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.
`areaServed` | AdministrativeArea or GeoShape or Place or Text | The geographic area where a service or offered item is provided. Supersedes serviceArea.
`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` | 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 Place or Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is valid. See also ineligibleRegion.
`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.
`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 preceeding 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.
`includesObject` | TypeAndQuantityNode | This links to a node or nodes indicating the exact quantity of the products included in the offer.
`ineligibleRegion` | GeoShape or Place or Text | The ISO 3166-1 (ISO 3166-1 alpha-2) or ISO 3166-2 code, the place, or the GeoShape for the geo-political region(s) for which the offer or delivery charge specification is not valid, e.g. a region where the transaction is not allowed. See also eligibleRegion.
`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 or Service | The item being offered.
`mpn` | Text | The Manufacturer Part Number (MPN) of the product, or the product to which the offer refers.
`offeredBy` | Organization or Person | A pointer to the organization or person making the offer. Inverse property: makesOffer.

`price`

Number or
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.

`priceCurrency` | Text | The currency (in 3-letter ISO 4217 format) of the 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. Supersedes reviews.
`seller` | Organization or Person | An entity which offers (sells / leases / lends / loans) the services / goods. A seller may also be a provider. Supersedes merchant, vendor.
`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 date when the item becomes valid.
`validThrough` | DateTime | The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.
`warranty` | WarrantyPromise | The warranty promise(s) included in the offer. Supersedes warrantyPromise.
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.
`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.
`image` | ImageObject or URL | An image of the item. This can be a URL or a fully described ImageObject.
`mainEntityOfPage` | CreativeWork or URL | 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, Freebase page, or official website.
`url` | URL | URL of the item.

Examples
Example 1
Without Markup Microdata RDFa JSON-LD

    <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>

Example 2
Without Markup Microdata RDFa JSON-LD

    <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 Version 3.0