---
name: product-schema
description: Add Product JSON-LD with offers, price, availability and real reviews to product pages. Use for ecommerce or physical product pages that need price and stock facts in search and AI shopping answers.
---

# Product schema

## Facts to use
- Google's product snippet requires `name` and one of `review`, `aggregateRating` or `offers`. Merchant listing results need more offer details such as `price`, `priceCurrency` and `availability`.
- Mark up only products and reviews that are on the page. Reviews must come from real customers.
- Keep price and availability the same as the page and the product feed.

## Workflow
1. For each product template, map fields: name, image, description, sku or gtin, brand, price, currency, availability, item condition, shipping and return details if shown.
2. Write one `Product` with one `Offer` (or `AggregateOffer` for many sellers).
3. Add `aggregateRating` and `review` only when real reviews show on the page.
4. Generate the block from the same data that renders the page, so it cannot drift.
5. Validate with the Rich Results Test.

## Template
```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Bottle 750 ml",
  "image": "https://example.com/img/bottle.jpg",
  "sku": "TB-750",
  "brand": { "@type": "Brand", "name": "Example Co" },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/bottle",
    "priceCurrency": "USD",
    "price": "24.00",
    "availability": "https://schema.org/InStock"
  }
}
```

## Checks
- [ ] Price and stock match the page.
- [ ] No errors in the Rich Results Test.

## Output
The JSON-LD template with field mapping per product template.

## Sources
- Google: Product snippet structured data. https://developers.google.com/search/docs/appearance/structured-data/product-snippet
- Google: Merchant listing structured data. https://developers.google.com/search/docs/appearance/structured-data/merchant-listing
- Schema.org: Product. https://schema.org/Product
