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

      Customer Story Gallery Stack

      Customer story galleries with CollectionPage, Article entries, FAQs, and breadcrumbs.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Case study galleries with multiple customer stories
      • Customer success hubs with filters and navigation
      • Story directories linking to individual articles

      What's included

      • Collection Page
        Open generator

        Represents the gallery hub page.

      • Describes each customer story entry.

      • Frequently Asked Questions
        Open generator

        Answers questions about story selection and submissions.

      • Breadcrumb
        Open generator

        Provides navigation context for the gallery.

      Required properties (stack union)

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

      datePublished
      description
      headline
      itemListElement[].name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      url

      Recommended properties (stack union)

      author.name
      dateModified
      description
      itemListElement[].item
      mainEntity.@id
      mainEntityOfPage
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name

      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/customers#page",
          "name": "Customer Stories",
          "description": "Explore how customers achieve results with Northwind.",
          "url": "https://www.example.com/customers",
          "mainEntity": {
            "@type": "Article",
            "@id": "https://www.example.com/customers/acme-logistics#story"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "Article",
          "@id": "https://www.example.com/customers/acme-logistics#story",
          "headline": "ACME Logistics Reduced Delivery Time by 22%",
          "description": "How ACME modernized its routing and cut delivery time.",
          "datePublished": "2025-04-12",
          "dateModified": "2025-04-14",
          "url": "https://www.example.com/customers/acme-logistics",
          "author": { "@type": "Organization", "name": "Northwind" }
        },
        {
          "@context": "https://schema.org",
          "@type": "Article",
          "@id": "https://www.example.com/customers/skyline-health#story",
          "headline": "Skyline Health Improved Patient Scheduling",
          "description": "Skyline increased appointment utilization with automation.",
          "datePublished": "2025-03-28",
          "dateModified": "2025-03-29",
          "url": "https://www.example.com/customers/skyline-health",
          "author": { "@type": "Organization", "name": "Northwind" }
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "How are stories selected?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "We feature customers who share measurable outcomes and approved quotes."
              }
            },
            {
              "@type": "Question",
              "name": "Can customers submit their own story?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Use the submission form to share your story for review."
              }
            },
            {
              "@type": "Question",
              "name": "Do you publish industry-specific galleries?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Filter by industry to find stories relevant to your business."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Customer Stories", "item": "https://www.example.com/customers" }
          ]
        }
      ]

      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 all stories in JSON-LD?

      Include one Article per story visible on the page to keep the list consistent.

      How do I handle filters?

      If filters change the list, keep the JSON-LD aligned to the default visible set.

      References