Cherry Seed

What product schema attributes does WooCommerce JSON-LD miss by default that AI shopping agents need?

JSON-LD product schema WooCommerce structured data AI shopping agents schema

Quick Answer

WooCommerce's default JSON-LD product schema omits several attributes that AI shopping agents weight heavily when deciding which products to recommend: aggregate review ratings, shipping cost and delivery time estimates, return policy details, product condition, brand name as a structured field, and availability with restock dates. According to schema.org product markup specifications, these fields are technically optional but practically essential for AI agent interoperability. AI shopping assistants from Google, Microsoft, and Perplexity use structured data completeness as a ranking signal when selecting which products to surface — stores with incomplete schema are deprioritised or excluded from agent-driven recommendations.

Full Answer

WooCommerce generates basic JSON-LD product schema automatically: name, description, price, currency, and a simple availability indicator. This covers the minimum viable structured data for traditional search engine rich results. But AI shopping agents evaluate product schema at a higher bar.

The missing fields fall into three categories. Trust signals: aggregate review ratings (aggregateRating with reviewCount and ratingValue), individual review markup, and brand as a structured field rather than embedded in the product name. These help AI agents assess product quality and merchant credibility without scraping unstructured page content.

Commercial attributes: shipping cost estimates (shippingDetails with shippingRate and deliveryTime), return policy details (hasMerchantReturnPolicy with returnPolicyCategory and merchantReturnDays), and product condition (itemCondition). AI agents making purchase recommendations need these to compare products across stores — a product without shipping data cannot be meaningfully compared to one that includes it.

Inventory intelligence: availability with granularity beyond simple in-stock or out-of-stock — including backorder status, preorder availability, and expected restock dates. Agents that guide purchasing decisions need to know not just whether a product is available now, but when it will be available if it is not.

Adding these fields requires either a structured data plugin that extends WooCommerce's default output, custom code in the theme's functions.php, or a server-side schema enrichment layer that injects complete markup before the page is served. The investment is modest — typically a few hours of configuration — but the visibility impact in AI-mediated shopping grows as more consumers interact with products through agents rather than traditional search results.

Sources

Programmatic Access

GET https://seresa.io/wp-json/cherry-tree-by-seresa/v1/seeds/938

Cite This Answer

Cherry Tree by Seresa - https://seresa.io/seed/ai-data-readiness/woocommerce-json-ld-product-schema-missing-attributes-ai-agents