Why Google Demands shippingDetails Structured Data

Shipping transparency is a primary driver of e-commerce conversions. Google Merchant Center now inspects product pages for OfferShippingDetails structured data. Without it, Google cannot verify shipping rates or delivery timelines, causing items to forfeit 'Fast & Free Delivery' badges in shopping carousels.

Required Properties for OfferShippingDetails

A complete shipping block requires: 1. shippingRate (currency and value); 2. shippingDestination (DefinedRegion with addressCountry); 3. deliveryTime with separate QuantitativeValue blocks for handlingTime (warehouse processing) and transitTime (carrier transit).

How Smart Schema Automates Shipping Markup

Smart Schema automatically attaches a compliant OfferShippingDetails block with your country currency and standard delivery time windows to every product offer. This immediately satisfies Google Merchant Center and clears diagnostic warnings across your catalog.

Code Example: Google-Compliant JSON-LD

"shippingDetails": {
  "@type": "OfferShippingDetails",
  "shippingRate": {
    "@type": "MonetaryAmount",
    "value": "0.00",
    "currency": "USD"
  },
  "shippingDestination": {
    "@type": "DefinedRegion",
    "addressCountry": "US"
  },
  "deliveryTime": {
    "@type": "ShippingDeliveryTime",
    "handlingTime": {
      "@type": "QuantitativeValue",
      "minValue": 1,
      "maxValue": 2,
      "unitCode": "DAY"
    },
    "transitTime": {
      "@type": "QuantitativeValue",
      "minValue": 3,
      "maxValue": 5,
      "unitCode": "DAY"
    }
  }
}
Fix This Automatically on Your Shopify Store

Avoid the risk of broken theme templates or lost Google Shopping revenue. Install Smart Schema Pro to resolve all Merchant Center errors in 1 click.

Start 14-Day Free Trial

Frequently Asked Questions

What happens if my shipping cost varies by US state or zip code?

For flat rates or free delivery thresholds, declare your primary standard rate in schema and define detailed carrier-calculated tables inside Merchant Center account settings.

Related Technical Glossary Terms
  • shippingDetails Schema: OfferShippingDetails allows online retailers to specify delivery transit duration, warehou...
  • hasMerchantReturnPolicy: hasMerchantReturnPolicy is a structured schema object that articulates return windows, res...
Related Troubleshooting Guides