All schema types
Data & Datasets
schema.org spec

ItemList

An ordered list of items — used for top lists, rankings, and curated collections.

What it is

ItemList communicates ranked or sequential collections. Use itemListOrder to indicate ordering (Ascending, Descending, Unordered). Useful for 'Best of' guides, top-N lists, and category landing pages.

Required properties
  • itemListElement
Recommended properties
  • itemListOrder
  • numberOfItems
  • name
JSON-LD example
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "Top 10 SEO Agencies in Toronto 2026",
  "itemListOrder": "https://schema.org/ItemListOrderDescending",
  "numberOfItems": 10,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "Organization",
        "name": "Toronto SEO"
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@type": "Organization",
        "name": "Agency Two"
      }
    }
  ]
}
</script>
Google rich result support

Carousel rich result for some types (Recipes, Movies, Restaurants, Courses).

When to use it
  • Best-of guides
  • Top lists
  • Ranked categories
  • Editorial roundups