XooCode(){

ProductCollection

ProductCollection is a Product subtype (also inheriting from CreativeWork via Collection) for a curated set of products listed or sold together: a gift bundle, a starter kit, a themed collection. It adds one property: includesObject, which takes TypeAndQuantityNode objects specifying what products are in the collection and in what quantities.

For a complete property walkthrough, see the Product example. Use ProductCollection when you are selling a bundle as a single item. If customers choose individual items and quantities, use separate Product listings with a shared ProductGroup or an ItemList instead.

Full example of schema.org/ProductCollection json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/ProductCollection
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ProductCollection",
  "name": "Xoo Holiday Gift Bundle",
  "description": "Gift set containing a XooTee Classic t-shirt (size M, Natural Bone) and a paperback copy of Children First by Jane Xoo.",
  "image": "https://xoocode.com/shop/gift-bundle/holiday-bundle-16x9.jpg",
  "includesObject": [
    {
      "@type": "TypeAndQuantityNode",
      "typeOfGood": { "@type": "Product", "name": "XooTee Classic", "@id": "https://xoocode.com/shop/xootee-classic#product" },
      "amountOfThisGood": 1
    },
    {
      "@type": "TypeAndQuantityNode",
      "typeOfGood": { "@type": "Book", "name": "Children First: A Practical Framework for Post-War Pediatric Care" },
      "amountOfThisGood": 1
    }
  ],
  "offers": {
    "@type": "Offer",
    "price": "695.00",
    "priceCurrency": "DKK",
    "availability": "https://schema.org/InStock",
    "url": "https://xoocode.com/shop/gift-bundle"
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid ProductCollection entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/ProductCollection (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ProductCollection",
  "name": "Xoo Holiday Gift Bundle",
  "includesObject": [
    { "@type": "TypeAndQuantityNode", "typeOfGood": { "@type": "Product", "name": "XooTee Classic" }, "amountOfThisGood": 1 }
  ],
  "offers": { "@type": "Offer", "price": "695.00", "priceCurrency": "DKK", "availability": "https://schema.org/InStock" },
  "image": "https://xoocode.com/shop/gift-bundle/holiday-bundle-16x9.jpg",
  "description": "Gift set: XooTee Classic and Children First book."
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Common ProductCollection mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    Listing bundle contents as plain text

    Wrong
    "description": "Includes a XooTee and a book"
    Right
    "includesObject": [{ "@type": "TypeAndQuantityNode", "typeOfGood": { "@type": "Product", "name": "XooTee Classic" }, "amountOfThisGood": 1 }]

    includesObject with TypeAndQuantityNode gives Google structured data about the bundle contents. A plain text description cannot be parsed for individual products, quantities, or cross-references to product knowledge graph entities.

Schema properties in this example

ProductCollectionnamedescriptionimageincludesObjectTypeAndQuantityNodetypeOfGoodamountOfThisGoodProductBookoffersOfferpricepriceCurrencyavailability

About the example data

A Xoo gift bundle containing a XooTee Classic and a copy of Jane Xoo's 1948 textbook, sold as a holiday gift set at the Xoo Code Shop.

Comments

Loading comments...

Leave a comment