Product Schema Stack
A combined Product + OfferShippingDetails + MerchantReturnPolicy + FAQPage JSON-LD bundle for product detail pages that need complete shopping signals.
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 is included
Core product entity with offer, pricing, images, and brand details.
Defines delivery regions, handling/transit times, and shipping rates to reduce shipping-related warnings.
Clarifies returns window, method, and fees; critical for Merchant Center alignment and shopper trust.
Answers top purchase blockers (shipping, returns, compatibility) and can earn FAQ rich results.
Properties across the bundle
Nested properties keep their parent path, such as offers.priceCurrency. Only publish values that match visible page content.
Required properties
- 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
- 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 this as one script tag, then replace every example value with data from the live page.
[
{
"@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."
}
}
]
}
]Implement and verify
- 01
Start with the live page
Confirm titles, prices, availability, policies, and visible FAQ content before generating markup.
- 02
Add one JSON-LD script
Use the combined example as a template in the document head or before the closing body tag.
- 03
Complete regional details
Fill shipping destinations and timing for every region the page actually serves.
- 04
Link the return policy
Use a stable MerchantReturnPolicy URL and keep its terms synchronized with the page.
- 05
Match visible answers
Add only FAQs that users can read on the same page, with identical answers.
- 06
Validate after changes
Run Rich Results Test after implementation and whenever price, availability, or policy data changes.
Common errors and fixes
- Missing currency or availability
Use ISO currency codes and complete schema.org availability URLs in Offer data.
- Incomplete shipping details
Include shippingDestination.addressCountry and deliveryTime.transitTime with units.
- Return policy is not connected
Reference MerchantReturnPolicy from the Offer and provide a stable public policy URL.
- FAQ answers differ from the page
Keep structured FAQ answers identical to visible answers.
Stack 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.