CONCEPT
JSON-LD
JSON-LD is machine-readable structured data — usually schema.org Product markup — that tells AI systems what you sell, at what price, and in which variants.
Overview
JSON-LD is machine-readable structured data — usually schema.org Product markup — that tells AI systems what you sell, at what price, and in which variants.
Why it matters for ecommerce
Product pages without valid JSON-LD force AI engines to infer details from messy HTML. Structured data makes recommendations accurate and cite-worthy.
How Surfacely measures this
Surfacely crawls your PDPs, validates Product schema fields, and generates a downloadable bundle you can paste or apply to fix gaps.
Where to find this in your report
Structured Data category in the score breakdown lists JSON-LD issues per page. The action plan includes export-ready Product schema snippets and a JSON-LD bundle download.
How to improve it
- Validate Product schema on top-revenue PDPs: name, image, offers, availability, sku/gtin.
- Expose variant-level Offer URLs — AI often recommends specific SKUs, not parent products.
- Add Organization and WebSite schema on the homepage for brand-level citations.
- Remove conflicting or duplicate JSON-LD blocks that confuse parsers.