← Back to all guides

Classification: Optional · Last updated: April 2026

ItemList Schema for Shopify: The Complete Guide

ItemList schema is one of the most commonly misunderstood structured data types for e-commerce. Many Shopify themes and apps add ItemList markup to collection pages, listing products as list items. However, Google's documentation is clear: ItemList carousel rich results are only supported for specific content types — and products are not one of them.

What Is ItemList Schema?

ItemList (schema.org/ItemList) is a JSON-LD structured data type that represents an ordered or unordered list of items. Each item in the list is a ListItem with a position, name, and URL. When Google supports ItemList for a content type, it can trigger a carousel rich result — a horizontally scrollable row of results from your site.

Which Content Types Support ItemList Carousels?

According to Google's official structured data documentation, carousel rich results from ItemList markup are only supported for these content types:

• Course — Lists of educational courses
• Movie — Lists of movies
• Recipe — Lists of recipes
• Restaurant — Lists of restaurants

Products are not on this list. Adding ItemList schema to your Shopify collection pages with products as list items will not trigger a carousel rich result. Google will simply ignore the ItemList markup for product listings.

Why ItemList Is Optional for Shopify

Schema Clinic classifies ItemList as Optional because:

• Google does not support ItemList carousel rich results for products
• Most Shopify stores sell products, not courses, movies, recipes, or restaurants
• Adding ItemList to product collection pages provides no visible search result benefit
• It's technically valid schema but functionally useless for typical Shopify use cases

If your Shopify store happens to sell courses or recipe content, ItemList becomes more relevant. For the vast majority of Shopify merchants, it's unnecessary.

Properties

For the content types that do support ItemList carousels:

• @type — "ItemList"
• itemListElement — An array of ListItem objects, each containing:
  • @type — "ListItem"
  • position — The item's position in the list (1-based integer)
  • url — The URL of the individual item's detail page

Each URL in the list must contain valid structured data for the relevant content type (e.g., each recipe page must have Recipe schema).

JSON-LD Example (Non-Product Use Case)

If you were running a recipe blog on Shopify:

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "url": "https://yourstore.com/blogs/recipes/chocolate-cake"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "url": "https://yourstore.com/blogs/recipes/banana-bread"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "url": "https://yourstore.com/blogs/recipes/lemon-tart"
    }
  ]
}

The Common Misconception

Many SEO plugins and Shopify apps add ItemList schema to collection pages, wrapping products in ListItem markup. This creates valid schema according to schema.org's specification, but Google does not use it for rich results. The app developers often imply it will improve search appearance, but Google's documentation simply doesn't support product carousels through ItemList.

This is why Schema Clinic marks ItemList as Optional and does not flag its absence on Shopify collection pages. Adding it won't hurt, but it won't help your search results either.

How Schema Clinic Handles ItemList

Schema Clinic detects ItemList schema when it's present but does not flag its absence as an issue. If ItemList markup is found, the audit validates the structure (correct position numbering, valid URLs) but does not generate recommendations to add it where it's missing, since it has no functional benefit for product-based Shopify stores.

← Back to all guides