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

      Product Schema Stack

      A combined Product + OfferShippingDetails + MerchantReturnPolicy + FAQPage JSON-LD bundle for product detail pages that need complete shopping signals.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Single product detail pages with offers, shipping, and returns info
      • Pages where FAQs resolve specs, compatibility, delivery, and returns
      • Merchants aligning on-page offers with Google Merchant Center policies

      What's included

      • Core product entity with offer, pricing, images, and brand details.

      • Offer Shipping Details
        Open generator

        Defines delivery regions, handling/transit times, and shipping rates to reduce shipping-related warnings.

      • Merchant Return Policy
        Open generator

        Clarifies returns window, method, and fees; critical for Merchant Center alignment and shopper trust.

      • Frequently Asked Questions
        Open generator

        Answers top purchase blockers (shipping, returns, compatibility) and can earn FAQ rich results.

      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
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      offers.availability
      offers.price
      offers.priceCurrency
      offers.shippingDetails[].deliveryTime.transitTime
      offers.shippingDetails[].shippingDestination.addressCountry
      offers.shippingDetails[].shippingRate.currency
      returnFees
      returnMethod
      returnPolicyCategory

      Recommended properties (stack union)

      aggregateRating.ratingValue
      aggregateRating.reviewCount
      applicableCountry
      brand.name
      category
      gtin13
      inStoreReturnsOffered
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      merchantReturnDays
      offers.shippingDetails[].deliveryTime.businessDays
      offers.shippingDetails[].deliveryTime.handlingTime
      offers.shippingDetails[].shippingDestination.addressRegion
      offers.shippingDetails[].shippingRate.value
      restockingFee
      sku
      url

      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": "Product",
          "@id": "https://www.example.com/products/ultra-headphones#product",
          "name": "ACME Ultra Wireless Headphones",
          "description": "Flagship over-ear Bluetooth 5.3 headphones with 45-hour battery life and adaptive noise cancelling.",
          "image": [
            "https://www.example.com/images/ultra-headphones-front.webp",
            "https://www.example.com/images/ultra-headphones-side.webp"
          ],
          "sku": "ACME-UW-01",
          "gtin13": "0001234567895",
          "brand": { "@type": "Brand", "name": "ACME Audio" },
          "category": "Headphones",
          "url": "https://www.example.com/products/ultra-headphones",
          "offers": {
            "@type": "Offer",
            "@id": "https://www.example.com/products/ultra-headphones#offer",
            "price": "199.00",
            "priceCurrency": "USD",
            "availability": "https://schema.org/InStock",
            "itemCondition": "https://schema.org/NewCondition",
            "url": "https://www.example.com/products/ultra-headphones",
            "shippingDetails": [
              {
                "@type": "OfferShippingDetails",
                "shippingDestination": {
                  "@type": "DefinedRegion",
                  "addressCountry": "US"
                },
                "deliveryTime": {
                  "@type": "ShippingDeliveryTime",
                  "handlingTime": {
                    "@type": "QuantitativeValue",
                    "minValue": 0,
                    "maxValue": 1,
                    "unitCode": "d"
                  },
                  "transitTime": {
                    "@type": "QuantitativeValue",
                    "minValue": 2,
                    "maxValue": 5,
                    "unitCode": "d"
                  }
                },
                "shippingRate": {
                  "@type": "MonetaryAmount",
                  "value": "0.00",
                  "currency": "USD"
                }
              }
            ],
            "hasMerchantReturnPolicy": "https://www.example.com/policies/returns#policy"
          },
          "aggregateRating": {
            "@type": "AggregateRating",
            "ratingValue": 4.7,
            "reviewCount": 128
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "MerchantReturnPolicy",
          "@id": "https://www.example.com/policies/returns#policy",
          "name": "30-day returns — ACME Audio",
          "url": "https://www.example.com/policies/returns",
          "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
          "merchantReturnDays": 30,
          "returnMethod": "https://schema.org/ReturnByMail",
          "returnFees": "https://schema.org/FreeReturn",
          "applicableCountry": "US",
          "inStoreReturnsOffered": true
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "Does it support Bluetooth 5.3 and multipoint?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. The Ultra supports Bluetooth 5.3 with multipoint so you can pair your laptop and phone at the same time."
              }
            },
            {
              "@type": "Question",
              "name": "What is the battery life?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Up to 45 hours of playback with noise cancelling on. A 10-minute quick charge provides up to 5 hours of listening."
              }
            },
            {
              "@type": "Question",
              "name": "How does the return policy work?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "You can return the headphones within 30 days in like-new condition. Start a prepaid label in your account or visit a retail store. See https://www.example.com/policies/returns for details."
              }
            }
          ]
        }
      ]

      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

      Why bundle these four types together?

      They mirror what shoppers and Google expect on a product detail page: product identity, a concrete offer with delivery signals, transparent returns, and clear answers to purchase blockers.

      Where do I place the combined JSON-LD?

      Place one `<script type="application/ld+json">` in the <head> or just before </body> of the product detail page. Keep data in sync with on-page content.

      How do I localize shipping and returns?

      Add multiple OfferShippingDetails entries for each region and specify `applicableCountry` in the MerchantReturnPolicy. Use local currency and localized FAQ answers per locale.

      References