OfferShippingDetails Schema Validation API

OfferShippingDetails schema markup enables Google to display your shipping costs and estimated delivery times directly in product rich results and Google Shopping. Showing shipping information upfront reduces cart abandonment and improves listing quality scores. Valid OfferShippingDetails is nested within an Offer on your product pages.

Required Properties

PropertyTypeDescription
shippingRaterich result
MonetaryAmountThe shipping cost. Include value and currency. Set value to 0 for free shipping.
shippingDestinationrich result
DefinedRegionThe destination for this shipping rate. Include addressCountry at minimum.
deliveryTimerich result
ShippingDeliveryTimeEstimated delivery time. Include transitTime with minValue and maxValue (days).

Recommended Properties

Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.

PropertyTypeDescription
transitTimeLabel
stringA label for the transit time (e.g. 'Standard', 'Express').
doesNotShip
booleanSet to true if the merchant does not ship to the specified destination.

Rich Result Eligibility

Rich result type: Shipping details in merchant product listing

Requirements: Required: shippingRate (MonetaryAmount), shippingDestination (DefinedRegion with addressCountry), and deliveryTime (ShippingDeliveryTime with transit days).

Example valid OfferShippingDetails JSON-LD

{
  "@context": "https://schema.org",
  "@type": "OfferShippingDetails",
  "shippingRate": {
    "@type": "MonetaryAmount",
    "value": "0",
    "currency": "USD"
  },
  "shippingDestination": {
    "@type": "DefinedRegion",
    "addressCountry": "US"
  },
  "deliveryTime": {
    "@type": "ShippingDeliveryTime",
    "handlingTime": {
      "@type": "QuantitativeValue",
      "minValue": 0,
      "maxValue": 1,
      "unitCode": "DAY"
    },
    "transitTime": {
      "@type": "QuantitativeValue",
      "minValue": 3,
      "maxValue": 5,
      "unitCode": "DAY"
    }
  },
  "transitTimeLabel": "Standard Shipping"
}

Validate via API

Validate this schema against Google's requirements in one API call:

curl "https://schemacheck.dev/api/v1/validate" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonld":{"@context":"https://schema.org","@type":"OfferShippingDetails","shippingRate":{"@type":"MonetaryAmount","value":"0","currency":"USD"},"shippingDestination":{"@type":"DefinedRegion","addressCountry":"US"},"deliveryTime":{"@type":"ShippingDeliveryTime","handlingTime":{"@type":"QuantitativeValue","minValue":0,"maxValue":1,"unitCode":"DAY"},"transitTime":{"@type":"QuantitativeValue","minValue":3,"maxValue":5,"unitCode":"DAY"}},"transitTimeLabel":"Standard Shipping"}}'

Official Documentation

Google Structured Data: OfferShippingDetails

Validate your OfferShippingDetails schema now

100 free validations/month. No credit card required.