XooCode(){

SomeProducts

SomeProducts is a Product subtype for describing a quantity of similar products: "approximately 50 XooTee Classics in stock," "a pallet of 200 units." It adds one property: inventoryLevel, a QuantitativeValue expressing how many units are available. Use it on wholesale or B2B pages where the buyer cares about stock quantity, not individual items.

For most ecommerce sites, Product with offers.availability is sufficient. SomeProducts is for situations where the exact quantity matters to the buyer: wholesale catalogs, raw materials suppliers, or liquidation sales. If your page just says "In Stock" or "Only 3 left," use Product with availability instead.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/SomeProducts
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SomeProducts",
  "name": "XooTee Classic - Wholesale Lot (Natural Bone, M)",
  "description": "Bulk lot of XooTee Classic t-shirts in Natural Bone, size M. Minimum order 25 units.",
  "image": "https://xoocode.com/shop/wholesale/xootee-bulk-16x9.jpg",
  "inventoryLevel": { "@type": "QuantitativeValue", "value": "142", "unitCode": "C62" },
  "brand": { "@id": "https://xoocode.com#organization" },
  "offers": {
    "@type": "Offer",
    "price": "350.00",
    "priceCurrency": "DKK",
    "availability": "https://schema.org/InStock",
    "eligibleQuantity": { "@type": "QuantitativeValue", "minValue": "25", "unitCode": "C62" }
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid SomeProducts 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/SomeProducts (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SomeProducts",
  "name": "XooTee Classic - Wholesale Lot",
  "inventoryLevel": { "@type": "QuantitativeValue", "value": "142", "unitCode": "C62" },
  "offers": { "@type": "Offer", "price": "350.00", "priceCurrency": "DKK", "availability": "https://schema.org/InStock" },
  "image": "https://xoocode.com/shop/wholesale/xootee-bulk-16x9.jpg",
  "description": "Bulk lot of XooTee Classic t-shirts. Minimum order 25 units."
}
</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 SomeProducts 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

    Using SomeProducts for a regular ecommerce listing

    Wrong
    "@type": "SomeProducts" for a standard product page
    Right
    Use Product with offers.availability for consumer listings; SomeProducts for wholesale/bulk

    SomeProducts is for wholesale and bulk contexts where the buyer needs to know exact stock quantities. For a standard add-to-cart page, Product with InStock/OutOfStock availability is the right choice.

Schema properties in this example

SomeProductsnamedescriptionimageinventoryLevelQuantitativeValueunitCodebrandoffersOfferpricepriceCurrencyavailabilityeligibleQuantity

Comments

Loading comments...

Leave a comment