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

      UGC Reviews Hub Stack

      Review hubs summarizing user reviews with AggregateRating, FAQs, and breadcrumbs.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • User review hubs for a category or brand
      • Community review pages with summarized ratings
      • Product category review roundups

      What's included

      • Collection Page
        Open generator

        Represents the review hub page.

      • Review
        Open generator

        Highlights representative user reviews on the hub.

      • Aggregate Rating
        Open generator

        Summarizes overall rating stats across the category.

      • Frequently Asked Questions
        Open generator

        Answers sourcing and moderation questions.

      • Breadcrumb
        Open generator

        Provides navigation context for the reviews hub.

      Required properties (stack union)

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

      author.name
      description
      itemListElement[].name
      itemReviewed.name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      ratingValue
      reviewBody
      reviewCount
      reviewRating.ratingValue
      url

      Recommended properties (stack union)

      bestRating
      datePublished
      itemListElement[].item
      mainEntity.@id
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      publisher.name
      reviewRating.bestRating
      worstRating

      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/reviews/coffee-makers#page",
    "name": "Coffee Maker Reviews",
    "description": "Community reviews and ratings for popular coffee makers.",
    "url": "https://www.example.com/reviews/coffee-makers",
    "mainEntity": {
      "@type": "AggregateRating",
      "@id": "https://www.example.com/reviews/coffee-makers#rating"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "AggregateRating",
    "@id": "https://www.example.com/reviews/coffee-makers#rating",
    "ratingValue": "4.6",
    "reviewCount": "1284",
    "bestRating": "5",
    "worstRating": "1"
  },
  {
    "@context": "https://schema.org",
    "@type": "Review",
    "@id": "https://www.example.com/reviews/coffee-makers#review-1",
    "reviewBody": "Easy to use and makes consistently great coffee.",
    "reviewRating": { "@type": "Rating", "ratingValue": "5", "bestRating": "5" },
    "author": { "@type": "Person", "name": "Taylor M." },
    "itemReviewed": { "@type": "Product", "name": "BrewMaster Pro" },
    "datePublished": "2025-04-20"
  },
  {
    "@context": "https://schema.org",
    "@type": "Review",
    "@id": "https://www.example.com/reviews/coffee-makers#review-2",
    "reviewBody": "Compact and affordable, but the carafe could be larger.",
    "reviewRating": { "@type": "Rating", "ratingValue": "4", "bestRating": "5" },
    "author": { "@type": "Person", "name": "Jordan L." },
    "itemReviewed": { "@type": "Product", "name": "CafePress Compact" },
    "datePublished": "2025-04-18"
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Where do the reviews come from?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Reviews are submitted by verified customers and moderated for quality."
        }
      },
      {
        "@type": "Question",
        "name": "Do you remove negative reviews?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "No. We only remove reviews that violate our guidelines."
        }
      },
      {
        "@type": "Question",
        "name": "How often are ratings updated?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Ratings update daily as new reviews are added."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
      { "@type": "ListItem", "position": 2, "name": "Reviews", "item": "https://www.example.com/reviews" },
      { "@type": "ListItem", "position": 3, "name": "Coffee Makers", "item": "https://www.example.com/reviews/coffee-makers" }
    ]
  }
]

      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

      Should I include every review?

      Include representative reviews shown on the page, and ensure AggregateRating matches the displayed stats.

      How do I handle multiple categories?

      Create separate review hubs per category to keep ratings accurate and consistent.

      References