Check explainer · v1
ItemList markup: what makes a carousel eligible
Last reviewed
A carousel is several results shown as one. The container has to say so: an ItemList with at least two items — and the page has to actually show them.
How this check works
Declared ItemList markup is read for itemListElement: the audit requires at least two entries. Pages without ItemList markup are not judged — absence is not a failure. Only the container is graded here; each item’s own type requirements (Recipe, Movie, Course) sit outside this check.
What does a failure look like?
A template marks a card grid as ItemList but emits a single item; itemListElement is an object instead of an array, so it reads as zero; a carousel renders only the first slide server-side, leaving one entry in the markup.
How to fix it, step by step
- Emit one itemListElement entry per item the page shows, and keep at least two.
- Keep the markup and the visible list in sync — entries for items that never render are not a list the user can see.
- Re-run the audit after template changes; the check reads the server-rendered markup only.
What does a pass or fail look like?
Good
8 itemListElement entries in page order under one ItemList — the container matches the visible grid.
Fail
One itemListElement entry: the markup claims a list, but there is nothing to carousel.
Frequently asked questions
Is one item ever enough?
No. A carousel is a set of alternatives; a single item has nothing to rotate through. The audit requires at least two entries, which is also the minimum a list-type rich result can use.
Does ItemList markup guarantee a carousel?
No. It is an eligibility signal: Google still decides per query and per vertical, and every item’s type has its own requirements. The audit grades the container only.
Which pages should carry ItemList markup?
Pages that present a set of items as one unit: category listings, recipe collections, course catalogs, movie lists. A single product page or article is not a list and should not claim to be one.
This rule is one of the checks the audit runs. Run the full site audit
Free preview; no account needed.