ItemListOrderType

ItemListOrderType is a 3-value Enumeration on ItemList.itemListOrder. Values: ItemListOrderAscending, ItemListOrderDescending, ItemListUnordered. Distinguishes a ranked "top 10" list from an unordered collection.

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

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

schema.org/ItemListOrderType

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "Best schema.org generators 2026",
  "itemListOrder": "https://schema.org/ItemListOrderDescending",
  "numberOfItems": 10
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListOrder": "https://schema.org/ItemListOrderDescending"
}
</script>

Google rich results this unlocks

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

Common ItemListOrderType 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
Omitting itemListOrder on a ranked list
Wrong
```
Top-10 list with no itemListOrder
```
Right
```
ItemListOrderDescending for "best to worst" rankings
```
Without the enum, consumers don't know whether position 1 is the top or just the first entry entered.

Schema properties in this example

ItemListOrderType Enumeration itemListOrder ItemListOrderAscending ItemListOrderDescending ItemListUnordered ItemList

About the example data

"ItemListOrderDescending" on the Xoo Code Best Schema Generators 2026 ranked list.

Comments

Loading comments...