SchemaValidatorSchemaValidator

ItemList Schema – Ranked Lists & Ordered Collections

Everything you need to know about ItemList schema markup. Learn how to structure ranked lists, top 10 collections, and ordered item groupings for better search visibility.

What is ItemList Schema?

ItemList schema describes ordered or unordered lists of items. Whether it's "Top 10 SEO Tools," "Best Wireless Headphones," or "Our Product Collection," ItemList tells search engines that this is a structured collection with meaningful relationships between items.

Why ItemList Matters

Content creators love lists - they're engaging and shareable. But without ItemList schema, search engines see your carefully curated "Top 10" list as just another web page. With ItemList, they understand the ranking, relationships, and value of each item in your collection.

The key insight: ItemList transforms "a page with some items" into "a structured ranking/collection that users find valuable" in search engines' understanding. For general collections, combine with CollectionPage schema for broader item groupings.

What ItemList Schema Includes

•List metadata: name, description, total items
•Item ordering: position numbers and ranking
•Item references: links to full item schemas
•List type: ordered rankings vs unordered collections

SEO Benefits You Get

🏆Enhanced list visibility in search results
📈Better click-through rates for list content
🎯Improved featured snippet potential
🔍Target long-tail ranking queries

Ready to validate your ItemList schema? Test your collection and list content markup.

✓Validate Itemlist Schema→

JSON-LD Example

ItemList schema for a "Top 10 SEO Tools" ranking:
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "Top 10 SEO Tools for 2024",
  "description": "Comprehensive ranking of the best SEO tools based on features, ease of use, and value for money",
  "numberOfItems": 10,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "SoftwareApplication",
        "@id": "https://toolreview.com/ahrefs",
        "name": "Ahrefs",
        "description": "Comprehensive SEO toolset with backlink analysis and keyword research",
        "applicationCategory": "SEOApplication",
        "offers": {
          "@type": "Offer",
          "price": "99",
          "priceCurrency": "USD"
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "item": {
        "@type": "SoftwareApplication",
        "@id": "https://toolreview.com/semrush",
        "name": "SEMrush",
        "description": "All-in-one digital marketing toolkit with powerful SEO features",
        "applicationCategory": "SEOApplication",
        "offers": {
          "@type": "Offer",
          "price": "119.95",
          "priceCurrency": "USD"
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 3,
      "item": {
        "@type": "SoftwareApplication",
        "@id": "https://toolreview.com/moz",
        "name": "Moz Pro",
        "description": "Professional SEO platform with domain authority and keyword tracking",
        "applicationCategory": "SEOApplication",
        "offers": {
          "@type": "Offer",
          "price": "79",
          "priceCurrency": "USD"
        }
      }
    }
  ]
}

Breaking Down the Structure

ItemList Properties:
  • @type: Must be "ItemList"
  • name: List title
  • description: List description
  • numberOfItems: Total items
ListItem Structure:
  • position: Item ranking/order
  • item: Full schema for the item
  • Items can be any schema type
  • Supports nested relationships

Practical Use Cases

🏆 Top 10 & Ranking Lists

"Best of" lists and rankings are perfect for ItemList schema. It tells search engines this is a carefully researched ranking, not just random content.

Example: "Top 10 SEO Tools" uses ItemList to show each tool's ranking with detailed schema information for better search visibility.

Impact: Ranking lists often appear in featured snippets and get higher click-through rates due to their structured, authoritative presentation.

📚 Course Syllabi & Learning Paths

Educational content with ordered sequences, like course curricula or learning roadmaps, benefit from ItemList schema to show progression and relationships.

Example: A "Web Development Learning Path" uses ItemList to structure beginner → intermediate → advanced courses in logical order.

Impact: Search engines understand the educational sequence, potentially leading to better visibility for learning content and improved user experience.

📋 Recipe Instructions & Ingredients

While Recipe schema handles full recipes, ItemList can structure ingredient lists or instruction steps with proper ordering.

Example: A recipe's ingredient list uses ItemList to show "2 cups flour" as position 1, "1 cup sugar" as position 2, etc.

Impact: Better recipe understanding and potential rich results for cooking-related searches.

Common Mistakes & How to Avoid Them

❌ Incorrect Position Numbers

Mistake: Starting positions at 0, using non-consecutive numbers, or not including position for every item.

Fix: Always use consecutive integers starting from 1. Each ListItem must have a unique position number that reflects its order in your list.

❌ Incomplete Item Schemas

Mistake: Using only basic properties in item schemas instead of complete, rich schemas.

Fix: Include full schema markup for each item (Product, Article, SoftwareApplication, etc.) with all relevant properties for maximum SEO value.

⚠️ Wrong ItemList Type

Mistake: Using ItemList for unordered collections when CollectionPage would be more appropriate.

Fix: Use ItemList for ranked/ordered lists. For general collections without specific ordering, consider CollectionPage instead.

⚠️ Missing numberOfItems

Mistake: Not including the total count of items in the list.

Fix: Always specify numberOfItems to help search engines understand the scope and completeness of your list.

SEO Tip: Combine with Rich Results

ItemList schema works especially well with content that can appear in rich results, like top 10 lists and rankings.

Featured Snippets
List content often appears in position zero
Knowledge Panels
Structured lists can enhance entity knowledge

Validate Your ItemList Schema

Test your ItemList schema implementation to ensure proper list structure and item ordering.

Test with SchemaValidator

Our comprehensive validation tool

Google Rich Results Test

Official Google testing tool

Additional JSON-LD Examples

Product Ranking List

ItemList schema for a ranked product comparison with detailed product information:
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "@id": "https://example.com/reviews/best-wireless-headphones-2024/#item-list",
  "name": "Best Wireless Headphones 2024 - Expert Reviews",
  "description": "Our comprehensive ranking of the top wireless headphones based on sound quality, battery life, comfort, and value for money. Updated January 2024.",
  "numberOfItems": 10,
  "itemListOrder": "https://schema.org/ItemListOrderDescending",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Sony WH-1000XM5",
      "item": {
        "@type": "Product",
        "@id": "https://example.com/products/sony-wh-1000xm5/#product",
        "name": "Sony WH-1000XM5 Wireless Headphones",
        "description": "Industry-leading noise cancellation with exceptional sound quality and 30-hour battery life.",
        "brand": {
          "@type": "Brand",
          "name": "Sony"
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.8",
          "ratingCount": "2847",
          "bestRating": "5"
        },
        "offers": {
          "@type": "Offer",
          "price": "349.99",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock"
        },
        "review": {
          "@type": "Review",
          "author": "Tech Review Pro",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": "5",
            "bestRating": "5"
          },
          "reviewBody": "The WH-1000XM5 represents the pinnacle of wireless audio technology with unmatched noise cancellation."
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Bose QuietComfort Ultra Headphones",
      "item": {
        "@type": "Product",
        "@id": "https://example.com/products/bose-quietcomfort-ultra/#product",
        "name": "Bose QuietComfort Ultra Headphones",
        "description": "Premium comfort and sound with world-class noise cancellation technology.",
        "brand": {
          "@type": "Brand",
          "name": "Bose"
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.7",
          "ratingCount": "1923",
          "bestRating": "5"
        },
        "offers": {
          "@type": "Offer",
          "price": "429.00",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock"
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Apple AirPods Max",
      "item": {
        "@type": "Product",
        "@id": "https://example.com/products/apple-airpods-max/#product",
        "name": "Apple AirPods Max",
        "description": "Seamless Apple ecosystem integration with spatial audio and premium build quality.",
        "brand": {
          "@type": "Brand",
          "name": "Apple"
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.5",
          "ratingCount": "3456",
          "bestRating": "5"
        },
        "offers": {
          "@type": "Offer",
          "price": "549.00",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock"
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Samsung Galaxy Buds 3 Pro",
      "item": {
        "@type": "Product",
        "@id": "https://example.com/products/samsung-galaxy-buds3-pro/#product",
        "name": "Samsung Galaxy Buds 3 Pro",
        "description": "Excellent value with premium features including 24-bit audio and adaptive ANC.",
        "brand": {
          "@type": "Brand",
          "name": "Samsung"
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.4",
          "ratingCount": "876",
          "bestRating": "5"
        },
        "offers": {
          "@type": "Offer",
          "price": "199.99",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock"
        }
      }
    },
    {
      "@type": "ListItem",
      "position": 5,
      "name": "Jabra Elite 8 Active",
      "item": {
        "@type": "Product",
        "@id": "https://example.com/products/jabra-elite-8-active/#product",
        "name": "Jabra Elite 8 Active",
        "description": "Sports-focused earbuds with excellent call quality and water resistance.",
        "brand": {
          "@type": "Brand",
          "name": "Jabra"
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": "4.3",
          "ratingCount": "654",
          "bestRating": "5"
        },
        "offers": {
          "@type": "Offer",
          "price": "149.99",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock"
        }
      }
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Ranking Methodology",
      "value": "Based on expert testing, user reviews, technical specifications, and value assessment"
    },
    {
      "@type": "PropertyValue",
      "name": "Testing Period",
      "value": "November 2023 - January 2024"
    },
    {
      "@type": "PropertyValue",
      "name": "Last Updated",
      "value": "January 15, 2024"
    }
  ],
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/reviews/best-wireless-headphones-2024"
  }
}
</script>

Article Series List

ItemList schema for an ordered series of articles or tutorials:
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "@id": "https://example.com/learn-photography/basics-series/#item-list",
  "name": "Complete Photography Basics Series",
  "description": "A comprehensive 10-part series covering fundamental photography concepts from exposure to composition. Perfect for beginners looking to master their craft.",
  "numberOfItems": 10,
  "itemListOrder": "https://schema.org/ItemListOrderAscending",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Understanding Your Camera",
      "item": {
        "@type": "Article",
        "@id": "https://example.com/learn-photography/camera-basics/#article",
        "headline": "Understanding Your Camera: A Beginner's Guide",
        "description": "Learn the basic components of your camera and how they work together to capture photos.",
        "datePublished": "2024-01-01T00:00:00Z",
        "author": {
          "@type": "Person",
          "name": "Sarah Martinez",
          "jobTitle": "Photography Instructor"
        },
        "timeRequired": "PT15M",
        "wordCount": 1200
      }
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Mastering Exposure Triangle",
      "item": {
        "@type": "Article",
        "@id": "https://example.com/learn-photography/exposure-triangle/#article",
        "headline": "The Exposure Triangle: ISO, Aperture, and Shutter Speed",
        "description": "Understanding how ISO, aperture, and shutter speed work together to control exposure.",
        "datePublished": "2024-01-03T00:00:00Z",
        "author": {
          "@type": "Person",
          "name": "Sarah Martinez",
          "jobTitle": "Photography Instructor"
        },
        "timeRequired": "PT20M",
        "wordCount": 1500
      }
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Composition Fundamentals",
      "item": {
        "@type": "Article",
        "@id": "https://example.com/learn-photography/composition/#article",
        "headline": "Photography Composition: Rules and Techniques",
        "description": "Learn essential composition techniques including rule of thirds, leading lines, and framing.",
        "datePublished": "2024-01-05T00:00:00Z",
        "author": {
          "@type": "Person",
          "name": "Sarah Martinez",
          "jobTitle": "Photography Instructor"
        },
        "timeRequired": "PT25M",
        "wordCount": 1800
      }
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Natural Light Photography",
      "item": {
        "@type": "Article",
        "@id": "https://example.com/learn-photography/natural-light/#article",
        "headline": "Working with Natural Light: Golden Hour and Beyond",
        "description": "Master the art of using natural light for beautiful, professional-looking photographs.",
        "datePublished": "2024-01-07T00:00:00Z",
        "author": {
          "@type": "Person",
          "name": "Sarah Martinez",
          "jobTitle": "Photography Instructor"
        },
        "timeRequired": "PT18M",
        "wordCount": 1400
      }
    },
    {
      "@type": "ListItem",
      "position": 5,
      "name": "Portrait Photography Basics",
      "item": {
        "@type": "Article",
        "@id": "https://example.com/learn-photography/portraits/#article",
        "headline": "Introduction to Portrait Photography",
        "description": "Essential techniques for capturing compelling portraits with proper lighting and posing.",
        "datePublished": "2024-01-09T00:00:00Z",
        "author": {
          "@type": "Person",
          "name": "Sarah Martinez",
          "jobTitle": "Photography Instructor"
        },
        "timeRequired": "PT22M",
        "wordCount": 1600
      }
    }
  ],
  "isPartOf": {
    "@type": "Course",
    "@id": "https://example.com/learn-photography/basics-course/#course",
    "name": "Photography Basics Master Course",
    "description": "Complete beginner's course covering all fundamental aspects of photography",
    "provider": {
      "@type": "Organization",
      "name": "PhotoLearn Academy"
    }
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Course Level",
      "value": "Beginner"
    },
    {
      "@type": "PropertyValue",
      "name": "Total Reading Time",
      "value": "Approximately 3 hours"
    },
    {
      "@type": "PropertyValue",
      "name": "Prerequisites",
      "value": "None - perfect for complete beginners"
    }
  ],
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/learn-photography/basics-series"
  }
}
</script>

SEO & Rich Results Notes

SEO Benefits

ItemList schema enhances list-based content visibility and user engagement:

  • • Rich list displays in search results with numbering and carousels
  • • Enhanced visibility for ranking and comparison content
  • • Better targeting for list-based search queries
  • • Improved content structure understanding by search engines
  • • Enhanced user experience through clear item relationships

Rich Results Eligibility

ItemList schema enables enhanced list displays:

  • • Numbered list displays in search results
  • • Carousel rich results for list content
  • • Enhanced list item previews and descriptions
  • • Position-based ranking visualization
  • • Integration with how-to and guide content

Reference: Google's Search Central recommends ItemList markup for enhanced list and ranking content display.

Important Warnings

  • Position Accuracy: List positions must accurately reflect the presented ranking or order. Misleading position numbers can result in user confusion and trust issues.
  • Content Consistency: List items must match the actual content presented on the page. Inconsistencies between markup and visible content harm search result accuracy.
  • Ranking Transparency: Clearly disclose ranking methodology and criteria. Hidden or unclear ranking systems can appear manipulative.
  • Regular Updates: Keep list positions and item information current. Outdated rankings can provide poor user experience and reduce credibility.

Official Documentation

Frequently Asked Questions

What is ItemList schema used for?

ItemList schema describes ordered or unordered lists of items, such as top 10 lists, rankings, search results, and collections. It helps search engines understand list relationships and can enable rich list displays in search results.

How do I add ItemList schema to my list pages?

Add JSON-LD structured data with itemListElement array containing ListItem objects. Each item needs position number and item (entity or URL), ordered from most to least important.

What are the required properties for ItemList schema?

Required properties include itemListElement array with ListItem objects containing position and item. For rich results, you'll also need name for the list title.

Does ItemList schema enable rich results?

Yes! ItemList schema enables rich list displays in search results, particularly for "how-to" guides, top lists, and carousels. It helps lists stand out with numbered or bulleted presentations.

How do I structure ItemList positions correctly?

Use sequential integers starting from 1 for ordered lists (rankings, top lists) or any consistent numbering for unordered lists. Position should reflect importance or ranking order.

Can ItemList items reference full schema objects?

Yes, itemListElement can contain full schema objects (like Product, Article) or simple URLs. Use full objects for rich item details or URLs for simpler list representations.

What's the difference between ItemList and BreadcrumbList schemas?

ItemList describes content lists and rankings, while BreadcrumbList describes navigation paths. ItemList is for collections of similar items, BreadcrumbList is for site navigation hierarchy.

How do I handle dynamic or changing lists?

Update position numbers when rankings change and keep item references current. Use dateModified to indicate when the list was last updated.

Can ItemList include additional item information?

Yes, ListItem can include additional properties like name, description, and image for enhanced item representation beyond basic position and URL.

How do I handle paginated lists?

Use separate ItemList schemas for each page with appropriate position numbering. Link pages through CollectionPage schema if applicable.

Does ItemList schema improve list content visibility?

Yes, ItemList enables rich list displays and carousels in search results. It helps list-based content stand out and provides clear item relationships for search engines.

How do I add criteria for ranked lists?

Use additionalProperty or description to explain ranking methodology. Include criteria like "based on user reviews" or "expert analysis" for transparency.

How often should I update ItemList schema?

Update when list contents change, rankings shift, or new items are added. Keep positions and item references accurate for current list representation.

Related Schema Types

Related: CollectionPage, Product, SoftwareApplication, Article, HowTo, Recipe

← Back to Schema Types