Missing field "shippingDetails" (in "offers")

Payments + Shipping & Fulfilment

Topic summary

Main issue: Google flags “Missing field ‘shippingDetails’ (in ‘offers’)” on Shopify product pages, sometimes alongside “hasMerchantReturnPolicy” and an invalid “brand” type.

Cause: Product JSON-LD lacks required schema fields. Theme files differ by store; the Product schema may live in product.liquid, main-product.liquid, or microdata-schema.liquid.

Fixes discussed:

  • Add shippingDetails under offers per Google’s Product schema guidelines, including shippingRate (MonetaryAmount + currency) and deliveryTime (BusinessDays, dayOfWeek, cutoffTime).
  • Add hasMerchantReturnPolicy with your return window.
  • Set brand to the “Brand” type (not “Organization”).

Implementation notes: Ensure edits are in the file that outputs product structured data. One approach used cart.total_price to set shippingRate, but a user noted crawlers see cart as 0; prefer fixed or rule-based values that mirror published shipping policy.

Outcomes: Several users report validation passing after adding the fields; screenshots provided. Others still experiencing errors asked for direct help. The thread remains partially unresolved.

Resources: Google Product structured data docs and an external how-to article were shared. Code snippets are central to the fixes.

Summarized with AI on December 20. AI used: gpt-5.
6

The place to add this will be in product.liquid under ‘offers’.

The liquid file outputs information about the product being viewed, no matter which product is being viewed. Google looks through this data to understand the variables about each product and if a variable is missing or doesn’t translate exactly between Shopify and Google, you get the error.

The error message Missing Field “ShippingDetails” (In “Offers”) is literally telling us that in the product.liquid file, under ‘offers’ there are no shipping details defined.

Please send me a private message if you’d like more help.

1 Like