Ecommerce Aggregate Offer Schema — AggregateOffer, Multi-Seller Listing & Price Range Structured Data

When to Use AggregateOffer vs Offer

Schema.org's AggregateOffer is a subtype of Offer designed specifically for situations where one product page represents multiple individual offers. The key decision point is whether your page shows one price or a price range that depends on seller or condition selection.

Shopify's default behavior is to always output a single Offer with the lowest available variant price — even for products where the highest variant price is 3× the lowest. This creates incorrect structured data: an AI agent sees "price: $29" for a product that actually costs up to $89 in the larger size. AggregateOffer corrects this by expressing the honest price range.

Full AggregateOffer Example — Multi-Seller Marketplace Page

The classic marketplace use case: a single product listed by multiple third-party sellers on a Shopify store using the Shopify marketplace framework or a multi-vendor app (WCFM, MultiSafepay MarketPlace, Zegsu).

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Sony WH-1000XM5 Wireless Noise-Cancelling Headphones",
  "description": "Industry-leading noise cancellation, 30-hour battery, multipoint Bluetooth. The Sony WH-1000XM5 available from multiple verified sellers.",
  "sku": "WH-1000XM5",
  "mpn": "WH1000XM5/B",
  "gtin13": "4548736132115",
  "brand": { "@type": "Brand", "name": "Sony" },
  "offers": {
    "@type": "AggregateOffer",
    "lowPrice": "249.00",
    "highPrice": "349.99",
    "priceCurrency": "USD",
    "offerCount": 4,
    "offers": [
      {
        "@type": "Offer",
        "price": "249.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/UsedCondition",
        "url": "https://example-marketplace.com/products/sony-wh1000xm5?seller=gadgetresale",
        "seller": {
          "@type": "Organization",
          "name": "GadgetResale Pro",
          "url": "https://gadgetresalepro.com",
          "sameAs": ["https://www.trustpilot.com/review/gadgetresalepro.com"],
          "aggregateRating": {
            "@type": "AggregateRating",
            "ratingValue": "4.7",
            "reviewCount": "312",
            "bestRating": "5"
          }
        },
        "description": "Grade A refurbished — 90-day warranty, original accessories included"
      },
      {
        "@type": "Offer",
        "price": "299.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/RefurbishedCondition",
        "url": "https://example-marketplace.com/products/sony-wh1000xm5?seller=certifiedtech",
        "seller": {
          "@type": "Organization",
          "name": "CertifiedTech Outlet",
          "url": "https://certifiedtech.com",
          "aggregateRating": {
            "@type": "AggregateRating",
            "ratingValue": "4.9",
            "reviewCount": "1240",
            "bestRating": "5"
          }
        },
        "description": "Sony Certified Refurbished — 1-year manufacturer warranty"
      },
      {
        "@type": "Offer",
        "price": "328.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/NewCondition",
        "url": "https://example-marketplace.com/products/sony-wh1000xm5?seller=audioworld",
        "seller": {
          "@type": "Organization",
          "name": "AudioWorld Direct",
          "url": "https://audioworlddirect.com",
          "aggregateRating": {
            "@type": "AggregateRating",
            "ratingValue": "4.8",
            "reviewCount": "892",
            "bestRating": "5"
          }
        },
        "description": "Brand new in sealed retail box — US warranty"
      },
      {
        "@type": "Offer",
        "price": "349.99",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/NewCondition",
        "url": "https://example-marketplace.com/products/sony-wh1000xm5?seller=premiumav",
        "seller": {
          "@type": "Organization",
          "name": "Premium AV Store",
          "url": "https://premiumavstore.com"
        },
        "description": "New sealed box, includes Sony 2-year extended warranty registration"
      }
    ]
  }
}
</script>

The outer AggregateOffer provides the price summary signal (lowPrice: $249, highPrice: $349.99, offerCount: 4). AI agents parsing this can answer "Sony WH-1000XM5 price range" ($249–$350) and "best-rated seller" (CertifiedTech at 4.9★ from 1,240 reviews) from structured data alone, without scraping the page.

Shopify Variant Price Range — AggregateOffer Pattern

The most common single-seller use case for AggregateOffer in Shopify is a product where size, configuration, or storage variant substantially changes the price. The standard Shopify JSON-LD outputs only the lowest variant price, which misrepresents the product to AI agents.

{% comment %} product-schema-aggregate.liquid — AggregateOffer for variant price ranges {% endcomment %}
{% assign prices = product.variants | map: 'price' %}
{% assign min_price = prices | sort | first %}
{% assign max_price = prices | sort | last %}
{% assign offer_count = product.variants | where: 'available', true | size %}

{% if min_price == max_price %}
  {% comment %} All variants same price — use single Offer {% endcomment %}
  {% assign use_aggregate = false %}
{% else %}
  {% assign use_aggregate = true %}
{% endif %}

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": {{ product.title | json }},
  "description": {{ product.description | strip_html | truncatewords: 60 | json }},
  "sku": {{ product.selected_or_first_available_variant.sku | json }},
  "brand": { "@type": "Brand", "name": {{ product.vendor | json }} },
  "offers": {
    {% if use_aggregate %}
    "@type": "AggregateOffer",
    "lowPrice": {{ min_price | money_without_currency | json }},
    "highPrice": {{ max_price | money_without_currency | json }},
    "offerCount": {{ offer_count }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "offers": [
      {% for variant in product.variants %}
      {% if variant.available %}
      {
        "@type": "Offer",
        "price": {{ variant.price | money_without_currency | json }},
        "priceCurrency": {{ cart.currency.iso_code | json }},
        "availability": "https://schema.org/InStock",
        "url": "{{ shop.url }}{{ product.url }}?variant={{ variant.id }}",
        "sku": {{ variant.sku | json }},
        "name": {{ variant.title | json }}
      }{% unless forloop.last %},{% endunless %}
      {% endif %}
      {% endfor %}
    ]
    {% else %}
    "@type": "Offer",
    "price": {{ min_price | money_without_currency | json }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "availability": {% if product.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %},
    "url": "{{ shop.url }}{{ product.url }}"
    {% endif %}
  }
}
</script>

This Liquid snippet conditionally outputs AggregateOffer (when variants have different prices) or a plain Offer (when all variants share the same price). The forloop.last check prevents trailing commas in the Offer array.

itemCondition Spectrum for Refurb and Resale Marketplaces

When AggregateOffer covers products across multiple condition states, the itemCondition on each individual Offer is what enables AI agents to filter by condition. The schema.org OfferItemCondition vocabulary has six values:

For each condition tier, add a description on the Offer explaining what that condition means for your specific grading system (e.g., "Grade A: 0–2 minor scratches, battery above 85%, all original accessories"). AI agents use this free-text description alongside the structured itemCondition to answer nuanced condition queries like "like-new condition, no major scratches."

Offer.seller with Trust Signals for Marketplace Pages

When multiple sellers list the same product, the seller identity and reputation are the primary differentiators. The Offer.seller Organization entity can carry trust signals that AI shopping agents use to rank offers beyond just price:

{
  "@type": "Offer",
  "price": "299.00",
  "priceCurrency": "USD",
  "seller": {
    "@type": "Organization",
    "name": "TechVault Pro",
    "url": "https://techvaultpro.com",
    "telephone": "+1-800-555-0199",
    "address": {
      "@type": "PostalAddress",
      "addressCountry": "US",
      "addressLocality": "Austin",
      "addressRegion": "TX"
    },
    "sameAs": [
      "https://www.trustpilot.com/review/techvaultpro.com",
      "https://www.bbb.org/us/tx/austin/profile/electronics/techvault-pro-0000-0000"
    ],
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.8",
      "bestRating": "5",
      "reviewCount": "2341"
    },
    "vatID": "US-27-3456789"
  },
  "warranty": {
    "@type": "WarrantyPromise",
    "durationOfWarranty": { "@type": "QuantitativeValue", "value": "1", "unitCode": "ANN" },
    "warrantyScope": "All defects, including battery, screen, and all components"
  }
}

The sameAs array pointing to Trustpilot and BBB profiles enables AI agents to cross-reference seller reputation from external verification sources — not just the seller's own claims. AI trust systems trained on marketplace data weigh third-party verification URLs in sameAs as stronger signals than unverifiable internal ratings. See Ecommerce Seller Organization Schema for the full seller trust signal pattern.

5 Common AggregateOffer Schema Mistakes

Related Resources

• Ecommerce Seller Organization Schema
• Shopify Pre-Owned & Resale Condition Schema
• Shopify ProductGroup & Variant Schema
• Ecommerce Product Condition Structured Data
• Shopify Warranty & Guarantee Structured Data
• CatalogScan Blog — AI Shopping Agent Optimization