XooCode(){

CollectionPage

CollectionPage is a direct WebPage subtype for pages whose purpose is to enumerate a set of items: category pages, tag pages, author archive pages, product listings. It is the parent of ImageGallery and VideoGallery.

It has no unique properties beyond inherited WebPage. The pattern is: set mainEntity to an ItemList enumerating the collected items.

Full example of schema.org/CollectionPage json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/CollectionPage
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "@id": "https://xoocode.com/shop/t-shirts#page",
  "name": "T-shirts — Xoo Code Shop",
  "url": "https://xoocode.com/shop/t-shirts",
  "description": "Xoo Code T-shirt range: XooTee Classic, XooTee Pro, XooTee Kids.",
  "mainEntity": {
    "@type": "ItemList",
    "numberOfItems": 3,
    "itemListElement": [
      { "@type": "ListItem", "position": 1, "url": "https://xoocode.com/shop/xootee-classic" },
      { "@type": "ListItem", "position": 2, "url": "https://xoocode.com/shop/xootee-pro" },
      { "@type": "ListItem", "position": 3, "url": "https://xoocode.com/shop/xootee-kids" }
    ]
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid CollectionPage entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/CollectionPage (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CollectionPage",
  "name": "T-shirts",
  "mainEntity": { "@type": "ItemList", "numberOfItems": 3 }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Common CollectionPage mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    ItemPage on a category page

    Wrong
    ItemPage on a listing
    Right
    CollectionPage for listings; ItemPage for single-item pages

    CollectionPage signals 'list'; ItemPage signals 'focus on one thing'.

  2. 02

    Missing ItemList mainEntity

    Wrong
    CollectionPage without an ItemList
    Right
    mainEntity: ItemList with itemListElement entries

    The ItemList is what makes the page's contents machine-readable; without it, it's just a typed WebPage.

Schema properties in this example

CollectionPageWebPagenameurldescriptionmainEntityItemListnumberOfItemsitemListElementListItempositionImageGalleryVideoGallery

Also mentioned in 3 other examples

CollectionPage also appears in ImageGallery, MediaGallery, and VideoGallery. See the full CollectionPage schema page for every reference.

About the example data

Xoo Code's product-category page for T-shirts.

Comments

Loading comments...

Leave a comment