Hidden Layer/Gold-Standard Product Schema
Schema Reference

Gold-Standard Product Schema

A complete Product JSON-LD with all Tier 1 and key Tier 2 properties. Copy it, replace placeholder values, and paste into your product page <head>.

Tier 1 — Required
✓
name
Product identification — required for all AI commerce queries
✓
image
Visual recognition — AI shopping agents need images for comparison
✓
brand
Entity resolution — links product to a known brand graph node
✓
sku
Unique identifier for price comparison and inventory lookup
✓
gtin
Global Trade Item Number — strongest disambiguation signal
✓
offers.price
Core commerce signal — agents compare prices across sources
✓
offers.priceCurrency
ISO 4217 code (USD, EUR, GBP) — required for price display
✓
offers.availability
In-stock status — agents filter out unavailable products
✓
offers.itemCondition
New vs. used — required for marketplace disambiguation
✓
offers.hasMerchantReturnPolicy
Google Rich Results requirement for return policy display
✓
offers.shippingDetails
Enables shipping cost display in Google Shopping + AI agents
Tier 2 — Recommended
●
description
Context extraction — LLMs use this for snippet generation
●
aggregateRating
3.2× more likely to appear in recommendation queries
●
category
Semantic classification — improves discovery precision
●
color
Attribute filtering in AI-driven shopping
●
material
Attribute filtering in AI-driven shopping
Sites with Tier 2 properties are 3.2× more likely to appear in AI recommendation queries compared to Tier 1 only.
Product JSON-LDTier 1 complete
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Blue Widget Pro",
  "description": "A professional-grade widget for advanced users. Detailed description helps AI agents surface your product in discovery and recommendation queries.",
  "image": [
    "https://example.com/images/widget-pro-front.jpg",
    "https://example.com/images/widget-pro-side.jpg"
  ],
  "brand": {
    "@type": "Brand",
    "name": "Widget Co"
  },
  "sku": "WGT-PRO-001",
  "gtin": "01234567890128",
  "offers": {
    "@type": "Offer",
    "price": "49.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "priceValidUntil": "2027-12-31",
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "US",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": "4.99",
        "currency": "USD"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "US"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": {
          "@type": "QuantitativeValue",
          "minValue": 0,
          "maxValue": 1,
          "unitCode": "DAY"
        },
        "transitTime": {
          "@type": "QuantitativeValue",
          "minValue": 1,
          "maxValue": 5,
          "unitCode": "DAY"
        }
      }
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "89"
  }
}
</script>