product-schema/SKILL.md
Facts to use
- Google's product snippet requires
nameand one ofreview,aggregateRatingoroffers. Merchant listing results need more offer details such asprice,priceCurrencyandavailability. - 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
- For each product template, map fields: name, image, description, sku or gtin, brand, price, currency, availability, item condition, shipping and return details if shown.
- Write one
Productwith oneOffer(orAggregateOfferfor many sellers). - Add
aggregateRatingandreviewonly when real reviews show on the page. - Generate the block from the same data that renders the page, so it cannot drift.
- Validate with the Rich Results Test.
Template
{
"@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