JSON-LD Schema for Shopify: Complete Guide for AI Search
Step-by-step guide to implementing Product schema on your Shopify store — structured specifically for AI agent consumption.
Why Shopify's default schema isn't enough
Shopify automatically generates basic schema.org Product markup. If you're running a standard theme, you already have some structured data. The problem: Shopify's default schema covers roughly 20-30% of what AI agents need.
Default Shopify schema typically includes: name, price, availability, image, description, and sometimes SKU. Enough for basic Google Shopping eligibility. Not enough for AI agent recommendation eligibility.
The JSON-LD approach
Inline JSON-LD is the recommended approach for adding structured data to Shopify product pages. It lives in a script tag in your page head — separate from HTML markup, easy to maintain, and fully readable by AI crawlers.
The required fields for AI recommendation eligibility:
@type: Product with name (clean, no marketing fluff), brand (@type Organization with name and url), and description (factual, attribute-dense — not marketing copy).
offers (@type Offer) with price, priceCurrency, availability (pulled dynamically from product.available), url, and seller Organization. The seller field is commonly missing and causes AI agents to reduce confidence in the data source.
Identifier fields — gtin13 or gtin8 (your product barcode from Shopify's Barcode field), mpn if applicable.
additionalProperty array — where your category-specific attributes live. This is where most brands fail and where the highest-impact fixes are.
Category-specific additionalProperty data
For skincare and beauty: skin type suitability, key actives with concentrations (e.g. "Retinol 1%"), certifications (cruelty-free, vegan, dermatologist-tested), fragrance-free status, SPF rating, and product form.
For supplements: serving size, servings per container, key active ingredient dosages, third-party testing certification (NSF, Informed Sport, USP), dietary flags (vegan, gluten-free, keto), and allergen information.
For apparel: material composition with percentages, care instructions, fit type, occasion tags, size range, and sustainability certifications.
For home decor: exact dimensions (H x W x D with units), material, weight capacity, indoor/outdoor rating, assembly required flag, and style classification.
Common implementation errors
Price mismatch — schema price doesn't match page price during sales. Fix: pull price from product.selected_or_first_available_variant.price dynamically.
Stale availability — schema says in-stock for out-of-stock products. Fix: use product.available dynamically.
Missing GTIN — most Shopify stores don't have barcode data entered. Fix: add barcode data to products in Shopify Admin under each product's Barcode field.
Overlong descriptions — dumping full marketing copy into schema description. Fix: write a separate, factual, attribute-dense description string specifically for schema.
Missing offers seller — the Offer entity needs a seller Organization field. Without it, AI agents reduce confidence in the data source.
Testing your implementation
Use Google's Rich Results Test to verify schema validity. Then test AI visibility directly — run 5-10 queries on ChatGPT and Perplexity for your product category and note whether your brand appears.
Run a free schema audit for your Shopify store at vialtry.com/grader.