S SCHEMA.BIZ
Other Extends: Intangible

ItemList Schema Markup

ItemList markup enables Google to display your content as a carousel in search results. It's used for listicles, product collections, recipe collections, and any page with an ordered list of similar items.

Eligible Rich Results

Carousel Rich Result

When to Use ItemList

Listicle articles Product collections Recipe roundups Ranking pages

Properties

Property Type Status Description
itemListElement ListItem (array) required Ordered list of items.
name Text optional List title.
numberOfItems Integer optional Total count.
itemListOrder ItemListOrderType optional Ascending, Descending, or Unordered.

JSON-LD Examples

Product List

A list of top-rated products.

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "Top 5 Running Shoes",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "url": "https://shoes.com/nike-air"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "url": "https://shoes.com/adidas-ultra"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "url": "https://shoes.com/asics-gel"
    }
  ]
}

Common Mistakes

Not including position numbers — each ListItem must have a position starting at 1.

Complete Guide to ItemList Schema Markup

ItemList markup enables Google's carousel rich result, displaying your listed items as a horizontally scrollable set of cards in search results. This is ideal for listicle content, product roundups, and curated collections.

Related Types

Ready to Create ItemList Markup?

Use our free generator to create valid ItemList JSON-LD markup with a visual form. No coding required.

Open Generator