ItemList schema markup enables carousel-style rich results in Google Search — showing a horizontal list of items (articles, recipes, movies, etc.) for a single search query. Carousels are typically used on list pages or summary pages that link to individual item detail pages. Valid ItemList structured data requires an ordered itemListElement array.
| Property | Type | Description |
|---|---|---|
itemListElementrich result | ListItem array | The ordered list of items. Each ListItem requires position (1, 2, 3…) and url or item (with @id or url). |
Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.
| Property | Type | Description |
|---|---|---|
name | string | The name of the list. |
description | string | A description of the list. |
numberOfItems | number | The total number of items in the list. |
url | URL | The URL of the page containing this list. |
Rich result type: Carousel rich result (horizontal list in search)
Requirements: Required: itemListElement array with ListItem objects, each containing position and url (or item with url). Each linked page should have its own schema markup for the full rich result.
{
"@context": "https://schema.org",
"@type": "ItemList",
"name": "Top 5 Pasta Recipes",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"url": "https://example.com/recipes/carbonara"
},
{
"@type": "ListItem",
"position": 2,
"url": "https://example.com/recipes/amatriciana"
},
{
"@type": "ListItem",
"position": 3,
"url": "https://example.com/recipes/cacio-e-pepe"
}
]
}Validate this schema against Google's requirements in one API call:
curl "https://schemacheck.dev/api/v1/validate" \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonld":{"@context":"https://schema.org","@type":"ItemList","name":"Top 5 Pasta Recipes","itemListElement":[{"@type":"ListItem","position":1,"url":"https://example.com/recipes/carbonara"},{"@type":"ListItem","position":2,"url":"https://example.com/recipes/amatriciana"},{"@type":"ListItem","position":3,"url":"https://example.com/recipes/cacio-e-pepe"}]}}'100 free validations/month. No credit card required.