XooCode(){

Enumeration

Enumeration is the root of every closed-value vocabulary in schema.org. Under it sit 531 named values across ~90 subtype enumerations — status types, categories, classifications. You almost never type an entity as bare Enumeration: you use a specific subtype like ItemAvailability, EventStatusType, DayOfWeek, or OfferItemCondition.

The important thing about Enumeration: the values are URIs, not strings. "availability": "https://schema.org/InStock", never "availability": "In stock".

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

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

schema.org/Enumeration
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Offer",
  "price": "19.99",
  "priceCurrency": "USD",
  "availability": "https://schema.org/InStock",
  "itemCondition": "https://schema.org/NewCondition"
}
</script>

Minimal valid version

The smallest markup that still produces a valid Enumeration 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/Enumeration (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Offer",
  "availability": "https://schema.org/InStock"
}
</script>

Google rich results this unlocks

Enumeration 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). Enumeration becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

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

    Free-text where an enum is expected

    Wrong
    "availability": "in stock"
    Right
    "availability": "https://schema.org/InStock"

    Enumeration values are URIs. Free text is lost on every consumer that filters by the enum.

Schema properties in this example

EnumerationIntangibleItemAvailabilityOfferItemConditionInStockNewCondition

Also mentioned in 36 other examples

Enumeration also appears in BoardingPolicyType, BookFormatType, BusinessEntityType, BusinessFunction, CarUsageType, ContactPointOption, DayOfWeek, DeliveryMethod, and 28 more. See the full Enumeration schema page for every reference.

About the example data

Every enum reference page on xoocode is ultimately an Enumeration descendant.

Comments

Loading comments...

Leave a comment