Item List Schema Generator
Create structured data for ranked lists, top 10 articles, and curated collections. Display your list items in Google’s carousel-rich results for courses, events, products, and more.
Item List schema creates structured lists that appear as carousels in Google Search. Perfect for “Top 10” articles, course lists, event listings, and product roundups. Required fields marked with *. Learn more about Carousel markup →
Pro Tip: For best results, ensure each list item has a unique URL. Item List schema works best for “Top X” articles, course directories, event listings, and product collections. Minimum 2 items required for carousel eligibility.
How to Add Item List Schema
Get your ranked lists and curated collections featured in Google's carousel-rich results for maximum visibility and engagement.
Where to Place the Code
Add the JSON-LD code to the <head> section of your list article page. The schema should represent the complete list visible on the page.
- One ItemList schema per list page
- Place in <head> section of the article
- Ensure list items match visible content
- Each item should have a unique URL
{
"@context": "https://schema.org",
"@type": "ItemList",
"name": "Top 10 List Title",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Item Name",
"url": "https://example.com/item-1"
}
]
}
</script>
Validation Checklist
Minimum 2 Items
Item List requires at least 2 list items to qualify for carousel display
Valid Item URLs
Each list item must have a unique, accessible URL
Correct Item Type
Use appropriate @type for items: Course, Event, Product, Movie, etc.
Sequential Positions
Item positions should start at 1 and increment sequentially
Why Item List Schema Matters
Item List schema enables rich carousel displays in Google Search, allowing users to browse your curated collections directly from search results. Perfect for "Best of" articles, directories, and ranked recommendations.
Course Lists
Best online courses, certifications
Event Lists
Upcoming events, festivals
Product Lists
Top products, gift guides
Movie Lists
Best films, recommendations
Google Carousel Requirements
- List must contain at least 2 items
- All items must be of the same type
- Each item requires a unique URL
- Page must be publicly accessible
- List content must be editorial/curated
Best Practices for Item Lists
Maximize your carousel visibility and user engagement with these proven strategies for structured list markup.
🔗 Include Item URLs
Every list item should link to a dedicated page. This enables click-throughs and helps Google understand your site structure.
📊 Use Proper Ordering
Set itemListOrder to indicate if your list is ranked (descending) or unordered. Ranked lists often get priority placement.
🎯 Match Content Exactly
Schema items must match the visible list on your page. Mismatches can result in manual actions or ranking drops.
🏷️ Add Detailed Item Schema
For richer results, nest detailed schema within each ListItem (Product, Course, Event with full properties).
📱 Optimize for Mobile
Carousels are prominently featured on mobile. Ensure your item pages are mobile-friendly and fast-loading.
🔄 Update Regularly
Fresh lists perform better. Update your "Top X" articles seasonally or annually and update schema accordingly.
Important: Item List schema is for editorial, curated lists only. Do not use for search results pages, category pages with filters, or automatically generated lists. Google may penalize sites that misuse this markup.