Cookies & analytics

    We use cookies for analytics and to serve ads. Accept to enable Google Analytics and AdSense. You can decline to stay opt-out.

    SwiftSchema Logo

    SwiftSchema

    Intuitive Schema Generation at Your Fingertips

    AboutLearnContact
      Stack

      Marketplace / Category Stack

      Category/listing pages with ItemList and Product detail linkage, plus FAQ and breadcrumb context for filters/shipping.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Category or collection pages listing products or listings
      • Marketplace verticals that need crawlable lists + product context
      • Pages where FAQs cover shipping, returns, and selection guidance

      What's included

      • Collection Page
        Open generator

        Identifies the page as a category/collection landing.

      • Structures the list of products/items in the category.

      • Provides product-level context for featured/primary item(s).

      • Frequently Asked Questions
        Open generator

        Answers common questions on shipping, returns, and selection.

      • Breadcrumb
        Open generator

        Provides navigation context for the category.

      Required properties (stack union)

      Ensure every applicable required property is present in your implementation. Nested props reference their parent objects (for example, `offers.priceCurrency`).

      description
      image
      itemListElement[].name
      itemListElement[].url
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      offers.availability
      offers.price
      offers.priceCurrency
      url

      Recommended properties (stack union)

      aggregateRating.ratingValue
      aggregateRating.reviewCount
      brand.name
      description
      itemListElement[].item
      itemListElement[].name
      itemListOrder
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      sku

      Combined JSON-LD

      Paste as a single script tag. Keep product details, offer data, shipping/returns, and FAQ answers in sync with the page.

      Validate
      [
        {
          "@context": "https://schema.org",
          "@type": "CollectionPage",
          "@id": "https://www.example.com/headphones#collection",
          "name": "Wireless Headphones",
          "description": "Shop wireless headphones with ANC, long battery life, and fast charging.",
          "url": "https://www.example.com/headphones"
        },
        {
          "@context": "https://schema.org",
          "@type": "ItemList",
          "itemListOrder": "https://schema.org/ItemListOrderDescending",
          "itemListElement": [
            {
              "@type": "ListItem",
              "position": 1,
              "name": "ACME Ultra Wireless Headphones",
              "url": "https://www.example.com/products/ultra-headphones"
            },
            {
              "@type": "ListItem",
              "position": 2,
              "name": "ACME Lite Wireless Headphones",
              "url": "https://www.example.com/products/lite-headphones"
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "Product",
          "@id": "https://www.example.com/products/ultra-headphones#product",
          "name": "ACME Ultra Wireless Headphones",
          "description": "Flagship over-ear Bluetooth headphones with ANC and 45-hour battery.",
          "image": [
            "https://www.example.com/images/ultra-headphones-front.webp"
          ],
          "sku": "ACME-UW-01",
          "brand": { "@type": "Brand", "name": "ACME Audio" },
          "offers": {
            "@type": "Offer",
            "price": "199.00",
            "priceCurrency": "USD",
            "availability": "https://schema.org/InStock",
            "url": "https://www.example.com/products/ultra-headphones"
          },
          "aggregateRating": {
            "@type": "AggregateRating",
            "ratingValue": 4.7,
            "reviewCount": 128
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "Do you offer free shipping?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes, free ground shipping in the US on orders over $50. Faster options available at checkout."
              }
            },
            {
              "@type": "Question",
              "name": "What is the return policy?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "30-day returns on unused items. Start a return from your account within 30 days of delivery."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Headphones", "item": "https://www.example.com/headphones" }
          ]
        }
      ]

      Implementation steps

      1. Start from your live product detail page content; ensure titles, prices, and availability match the page.
      2. Embed one JSON-LD script in the head or just before the closing body tag using the combined example as a template.
      3. Fill shipping details for each region you serve and keep them aligned with on-page shipping tables.
      4. Attach your canonical MerchantReturnPolicy URL and keep the policy text in sync with Merchant Center.
      5. Add 3–6 FAQs that address purchase blockers (shipping, returns, compatibility) and keep answers consistent with visible content.
      6. Validate in the Rich Results Test and revalidate after price/availability/policy changes.

      Common errors and fixes

      FAQs

      Do I need Product for every list item?

      Include representative Product objects for featured items; keep the ItemList to structure the list itself.

      How should I handle pagination?

      Ensure canonical points to the view you want indexed; include rel=prev/next in HTML and keep ItemList aligned to the visible page.

      References