Stack

Marketplace Buyer Protection Stack

Buyer protection program pages with WebPage + Offer + MerchantReturnPolicy, FAQs, and breadcrumb navigation.

Open generator Validate in Rich Results Test

When to use this stack

Marketplace buyer protection program overview pages
Purchase protection eligibility and claims pages
Pages where FAQs clarify refunds and claim timelines

What's included

Web Page
Open generator
Defines the buyer protection page and its summary.
Offer
Open generator
Expresses the buyer protection benefit or guarantee.
Merchant Return Policy
Open generator
Captures the protection policy terms and eligibility.
Frequently Asked Questions
Open generator
Answers eligibility, claim process, and coverage questions.
Breadcrumb
Open generator
Provides navigation context for the buyer protection page.

Required properties (stack union)

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

availability

description

itemListElement[].name

mainEntity[].@type=Question

mainEntity[].acceptedAnswer.text

name

price

priceCurrency

returnFees

returnMethod

returnPolicyCategory

url

Recommended properties (stack union)

applicableCountry

dateModified

description

eligibleRegion

inLanguage

itemListElement[].item

mainEntity[].acceptedAnswer.text

mainEntity[].author.name

mainEntity[].name

merchantReturnDays

priceValidUntil

returnShippingFeesAmount

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": "WebPage",
    "@id": "https://www.example.com/help/buyer-protection#page",
    "name": "Buyer Protection Program",
    "description": "Coverage for eligible marketplace purchases, including refunds and claim support.",
    "url": "https://www.example.com/help/buyer-protection",
    "inLanguage": "en-US",
    "dateModified": "2025-08-20"
  },
  {
    "@context": "https://schema.org",
    "@type": "Offer",
    "@id": "https://www.example.com/help/buyer-protection#offer",
    "name": "Marketplace Buyer Protection",
    "description": "Up to $500 purchase protection for eligible orders.",
    "price": "0.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "eligibleRegion": "US",
    "url": "https://www.example.com/help/buyer-protection#claim"
  },
  {
    "@context": "https://schema.org",
    "@type": "MerchantReturnPolicy",
    "@id": "https://www.example.com/help/buyer-protection#policy",
    "name": "Buyer Protection Policy",
    "url": "https://www.example.com/help/buyer-protection",
    "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
    "merchantReturnDays": 14,
    "returnMethod": "https://schema.org/ReturnByMail",
    "returnFees": "https://schema.org/FreeReturn",
    "applicableCountry": "US"
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "What purchases are covered?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Eligible purchases made on the marketplace and paid through the platform are covered."
        }
      },
      {
        "@type": "Question",
        "name": "How do I file a claim?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Submit a claim through your order page within 14 days of delivery."
        }
      },
      {
        "@type": "Question",
        "name": "When will I receive a refund?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Approved claims are refunded within 5-7 business days."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
      { "@type": "ListItem", "position": 2, "name": "Help Center", "item": "https://www.example.com/help" },
      { "@type": "ListItem", "position": 3, "name": "Buyer Protection", "item": "https://www.example.com/help/buyer-protection" }
    ]
  }
]

Implementation steps

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

Common errors and fixes

Missing currency or availability: ensure `offers.priceCurrency` and `offers.availability` use ISO currency codes and schema URLs.
ShippingDetails missing destination or transit time: include `shippingDestination.addressCountry` and `deliveryTime.transitTime` with units.
MerchantReturnPolicy not linked: reference it from the Offer via `hasMerchantReturnPolicy` and provide a stable policy URL.
FAQ answers don't match the page: keep FAQ content identical to visible answers to avoid review or manual actions.

FAQs

Should I include separate policies for categories?

If policies differ by category, add multiple MerchantReturnPolicy entries with distinct @id values.

Do I need to list claim limits?

Yes. Mention claim limits in the Offer description and align with on-page policy text.

SwiftSchema

Intuitive Schema Generation at Your Fingertips