Shopify's optimizing-for-AI doc names 'sizing guides, material information, and care instructions' explicitly. The Catalog-optimization doc reinforces the description-completeness requirement. Three structured layers that AI agents read — and that classical theme PDPs often hide behind JavaScript-rendered tabs that AI crawlers can't parse. The fix is rendering them inline in the description body or in metafields that the theme outputs in initial HTML.
The verbatim instruction is from Shopify1. The Catalog reinforcement is from the optimization doc2. The implementation choice is between description-body inline rendering (works for all themes) and metafield-based rendering (works for themes that natively support metafield blocks in the PDP layout).
§01Where
Where to put each field on Shopify
Three placement options, in descending order of universality. (1) Inline in the description body — works on every theme. (2) Metafields rendered by the theme via metafield blocks — works on themes that support custom metafield rendering. (3) Custom theme blocks with hardcoded sections — works but adds theme-customisation overhead.
Placement
Compatibility
Best for
Description body (inline)
All themes
Universal — start here
Metafield rendering
Themes with metafield block support
Stores with > 100 SKUs and consistent fields
Custom theme block
Custom theme work
Brand-specific PDP layouts
§02Blockers
Theme-side blockers AI crawlers hit
Two common blockers. (1) Tab components that hide content under a click — JavaScript renders the content on user interaction, but AI crawlers fetch the initial HTML once and don't click. Content hidden in tabs may be invisible to AI. (2) Accordion components that lazy-render content — same problem. Both are common in 'product detail' themes.
§03Templates
Templates by category
Five category examples. Each shows the three fields (sizing, material, care) as structured blocks within the product description body. The pattern adapts to category — sizing is universal in apparel, material is universal in furniture, care is universal in skincare. Apply the relevant fields per category.
Category
Sizing format
Material format
Care format
Apparel
Size chart in cm/inches; fit guide
Fabric composition % + weight gsm
Wash temp + iron + dry-clean
Furniture
Dimensions L×W×H; weight
Material composition + finish
Cleaning + assembly
Skincare
Volume ml; usage frequency
Active ingredients % + base ingredients
Storage + patch test
Supplements
Servings per container
Active ingredient + form (powder/capsule/etc)
Dosage + interactions
Jewelry
Size guide + chain length
Metal + stone + plating
Cleaning + storage
§04Checklist
Field placement checklist
Six checks per product. Most stores benefit from rendering these inline in the description body first; metafield rendering is the second-phase upgrade once the inline pattern is proven.
Identify which of the three fields applies to this product category.
Draft the structured block (sizing chart, material composition, care routine).
Place the block inline in the description body (not in a tab or accordion).
View page source. Confirm the block text appears in initial HTML.
Open the PDP on mobile. Confirm the block reads cleanly without horizontal scroll.
Test in ChatGPT: ask 'what's the material of [your product]' and confirm an accurate answer.
