CollectionPage Schema – Complete Guide to Item Collections & Categories
CollectionPage schema markup helps search engines understand and display your category pages, search results, and curated collections, enabling rich snippets and enhanced navigation in search results.
What is CollectionPage Schema?
CollectionPage schema describes pages that present collections of items, such as product categories, search results, blog post archives, or curated galleries. It tells search engines that this page contains multiple related items organized in a structured collection.
Why CollectionPage Schema Matters
CollectionPage schema is essential for e-commerce and content-heavy websites. It helps search engines understand the relationship between collection pages and individual items, enabling better search result displays and improved user navigation.
The key insight: CollectionPage transforms generic category pages into structured, searchable collections that search engines can properly index and display.
What CollectionPage Schema Includes
SEO Benefits You Get
Ready to validate your CollectionPage schema? Test your curated content and gallery markup.
✓Validate Collectionpage Schema→CollectionPage Schema Implementation
Complete CollectionPage Schema Example
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"@id": "https://example.com/products/electronics/#collection",
"name": "Electronics Collection",
"description": "Browse our complete collection of premium electronics including smartphones, laptops, and accessories.",
"url": "https://example.com/products/electronics",
"mainEntity": {
"@type": "ItemList",
"numberOfItems": 24,
"itemListElement": [
{
"@type": "Product",
"position": 1,
"name": "iPhone 15 Pro",
"url": "https://example.com/products/iphone-15-pro",
"image": "https://example.com/images/iphone-15-pro.jpg",
"offers": {
"@type": "Offer",
"price": "999.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
},
{
"@type": "Product",
"position": 2,
"name": "MacBook Pro 16\"",
"url": "https://example.com/products/macbook-pro-16",
"image": "https://example.com/images/macbook-pro-16.jpg",
"offers": {
"@type": "Offer",
"price": "2499.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
]
},
"breadcrumb": {
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://example.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Products",
"item": "https://example.com/products"
},
{
"@type": "ListItem",
"position": 3,
"name": "Electronics",
"item": "https://example.com/products/electronics"
}
]
},
"publisher": {
"@type": "Organization",
"@id": "https://example.com/#organization"
}
}
</script>Minimal CollectionPage Schema Example
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Product Category",
"description": "Collection of related products",
"mainEntity": {
"@type": "ItemList",
"numberOfItems": 10,
"itemListElement": [
{
"@type": "Product",
"position": 1,
"name": "Sample Product",
"url": "https://example.com/product/1"
}
]
}
}
</script>Required vs Recommended Properties
Required Properties
- •
name- Collection title - •
mainEntity- ItemList with collection items
Recommended Properties
- •
description- Collection description - •
url- Page URL - •
breadcrumb- Navigation breadcrumbs
CollectionPage Schema Best Practices
Content & Accuracy
numberOfItems matches actual items displayedAdvanced Features
Common CollectionPage Schema Mistakes
❌ Wrong Item Count
Mistake: Setting numberOfItems to a static value that doesn't match actual items.
Fix: Use dynamic counting or update the count when items are added/removed.
❌ Incorrect Positions
Mistake: Using non-sequential position numbers or starting from 0 instead of 1.
Fix: Always start positions at 1 and increment by 1 for each item.
❌ Missing mainEntity
Mistake: Using CollectionPage without the required mainEntity ItemList.
Fix: Always include mainEntity with @type: "ItemList" containing your collection items.
❌ Broken Item URLs
Mistake: Including URLs that return 404 errors or don't exist.
Fix: Validate all URLs in your itemListElement before publishing schema markup.
Validate Your CollectionPage Schema
Testing Tools & Resources
Official Google Tools
Implementation Check
- • Verify item count matches display
- • Check all URLs are accessible
- • Validate position numbering
- • Test with Google's Rich Results Test
Frequently Asked Questions
What is CollectionPage schema used for?
CollectionPage schema describes pages that present collections of items, such as product categories, search results, or curated galleries. It helps search engines understand that the page contains multiple related items organized in a structured collection.
How do I implement CollectionPage schema for e-commerce category pages?
Use CollectionPage with mainEntity containing an ItemList. Include position numbers for each item, and use Product schema for individual products with offers, images, and ratings. Ensure accurate item counts match your display.
Can CollectionPage schema help with pagination?
Yes, CollectionPage works well with paginated content. Use consistent numbering across pages and ensure each page's CollectionPage reflects only the items displayed on that specific page.
What's the difference between CollectionPage and ItemList schemas?
CollectionPage describes a web page containing a collection, while ItemList is the structured list within it. CollectionPage provides page-level context, and ItemList provides the item organization and numbering.
How many items should I include in my CollectionPage schema?
Include all items currently displayed on the page. For paginated results, only include items from the current page. Use accurate numberOfItems counts to help search engines understand collection size.
Does CollectionPage schema improve search rankings?
While not a direct ranking factor, CollectionPage schema improves search result displays and helps search engines better understand and categorize your content, potentially leading to better visibility for collection-type pages.
Can I use CollectionPage for blog post archives?
Yes, CollectionPage works well for blog archives, category pages, and any organized collection of content. Use Article or BlogPosting schemas for individual items within the collection.
What properties are required for CollectionPage schema?
The name property is required to identify the collection. For optimal implementation, include mainEntity with an ItemList containing your collection items, each with proper position numbering.
How do I handle dynamic collections like search results?
For search results, generate CollectionPage schema dynamically based on the current search query and results. Update item counts and positions to reflect the actual search results displayed.
Are there any limitations on CollectionPage item counts?
There's no strict limit, but focus on the most relevant items. For very large collections, consider pagination and only include items from the current page in your schema markup.
Can CollectionPage schema work with different item types?
Yes, CollectionPage can contain any type of items - products, articles, events, recipes, etc. Use appropriate schemas for individual items within your ItemList.
How often should I update CollectionPage schema?
Update schema whenever collection contents change significantly. For dynamic collections like product categories, ensure item counts and availability stay current.
Does CollectionPage schema affect rich results?
CollectionPage can enhance how search engines display collection-type pages and may contribute to better featured snippets, especially when combined with rich item schemas like Product or Recipe.
What's the best way to test CollectionPage implementation?
Use Google's Rich Results Test to validate your schema. Check that item positions are sequential, item counts are accurate, and all item URLs are accessible and properly marked up.
Related Schema Types
Additional JSON-LD Examples
Recipe Collection Example
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Easy Weeknight Dinner Recipes",
"description": "Collection of quick and easy dinner recipes perfect for busy weeknights",
"url": "https://example.com/recipes/weeknight-dinners",
"mainEntity": {
"@type": "ItemList",
"numberOfItems": 12,
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "Recipe",
"name": "One-Pan Chicken Stir Fry",
"image": "https://example.com/images/chicken-stir-fry.jpg",
"author": {
"@type": "Person",
"name": "Chef Maria"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.5",
"ratingCount": "234"
},
"totalTime": "PT25M",
"recipeYield": "4 servings"
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "Recipe",
"name": "15-Minute Pasta Primavera",
"image": "https://example.com/images/pasta-primavera.jpg",
"author": {
"@type": "Person",
"name": "Chef Maria"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.3",
"ratingCount": "189"
},
"totalTime": "PT15M",
"recipeYield": "6 servings"
}
}
]
},
"breadcrumb": {
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://example.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "Recipes",
"item": "https://example.com/recipes"
},
{
"@type": "ListItem",
"position": 3,
"name": "Weeknight Dinners",
"item": "https://example.com/recipes/weeknight-dinners"
}
]
}
}
</script>Article Archive Collection Example
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Digital Marketing Articles",
"description": "Comprehensive collection of articles covering SEO, content marketing, and digital strategy",
"url": "https://example.com/guides/category/digital-marketing",
"mainEntity": {
"@type": "ItemList",
"numberOfItems": 25,
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "Article",
"headline": "SEO Trends 2024: What Marketers Need to Know",
"datePublished": "2024-01-15T10:00:00Z",
"author": {
"@type": "Person",
"name": "Sarah Johnson",
"jobTitle": "SEO Director"
},
"image": "https://example.com/images/seo-trends-2024.jpg",
"wordCount": 2100
}
},
{
"@type": "ListItem",
"position": 2,
"item": {
"@type": "Article",
"headline": "Content Marketing ROI: Measuring What Matters",
"datePublished": "2024-01-10T14:30:00Z",
"author": {
"@type": "Person",
"name": "Mike Chen",
"jobTitle": "Content Strategist"
},
"image": "https://example.com/images/content-marketing-roi.jpg",
"wordCount": 1850
}
}
]
},
"about": {
"@type": "Thing",
"name": "Digital Marketing",
"description": "Strategies and tactics for online marketing and customer acquisition"
},
"publisher": {
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Marketing Insights Blog"
}
}
</script>SEO & Rich Results Notes
SEO Benefits
CollectionPage schema enhances search engine understanding of collection-type pages, potentially improving:
- • Better categorization of collection content
- • Enhanced search result displays for category pages
- • Improved indexing of paginated and filtered content
- • Rich snippets for collection metadata
Rich Results Eligibility
While CollectionPage itself doesn't directly enable rich results, it enhances the presentation of:
- • Product carousels when combined with Product schema
- • Recipe collections for cooking search features
- • Article collections for topic clusters
- • Enhanced category page displays in search results
Reference: Google's Structured Data guidelines emphasize the importance of accurate collection markup for better search understanding.
Important Warnings
- Accurate Item Counts: Always ensure numberOfItems matches the actual items displayed. Inaccurate counts can harm search visibility.
- Sequential Positioning: Item positions must be sequential starting from 1. Non-sequential or zero-based numbering can cause validation errors.
- Working URLs: All item URLs in the collection must be accessible. Broken links can negatively impact search engine trust.
- Content Relevance: Only include items that are actually relevant to the collection theme. Irrelevant items can confuse search engines.
Official Documentation
- Schema.org: CollectionPage specification
- Google Search Central: Structured Data Guidelines
- Rich Results Test: Validate your CollectionPage implementation