ItemAvailability

ItemAvailability is a 12-value Enumeration used on Offer.availability. It is one of the most-read enums on schema.org because Google's merchant-listing and product rich results filter against it.

Values: InStock, OutOfStock, PreOrder, PreSale, BackOrder, SoldOut, Discontinued, LimitedAvailability, MadeToOrder, InStoreOnly, OnlineOnly, Reserved.

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

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

schema.org/ItemAvailability

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Xoo Code structured-data handbook",
  "offers": {
    "@type": "Offer",
    "price": "29.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "availabilityStarts": "2026-04-01"
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid ItemAvailability 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/ItemAvailability (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Offer",
  "availability": "https://schema.org/InStock"
}
</script>

Google rich results this unlocks

ItemAvailability is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). ItemAvailability becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common ItemAvailability 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.

01
Free text availability
Wrong
```
"availability": "In stock"
```
Right
```
"availability": "https://schema.org/InStock"
```
Google's merchant-listing rules only fire on the canonical enum URIs.

Schema properties in this example

ItemAvailability Enumeration availability InStock OutOfStock PreOrder SoldOut Discontinued

Also mentioned in 1 other example

ItemAvailability also appears in Enumeration. See the full ItemAvailability schema page for every reference.

About the example data

"In stock at the Xoo Code general store" — the availability read into every product card.

Comments

Loading comments...