Shopify reference

This file supplements SKILL.md with terminology and links. For block-type patterns when the theme uses blocks/, follow Discover allowed block types and Analyze block and section schemas in the JSON editing workflow. Optional theme-specific recipes are indexed in the example catalog. Always confirm type values and settings against the target theme's sections/, blocks/, and {% schema %}.

Standard templates

Alternate templates: <resource>.<suffix>.json — e.g. product.preorder.json, page.contact.json.

Platform limitations

Per Shopify's JSON templates documentation:

• Up to 25 sections per template; up to 50 blocks per section
• Up to 1,000 JSON templates per theme
• Root may include optional layout (layout filename or false) and wrapper (HTML wrapper for all sections); see the docs for syntax

Concepts

• Section type: String matching a section the theme provides (usually the basename of sections/<type>.liquid).
• Section instance id: Key in the template's sections object; can differ from type (e.g. two "type": "image-banner" sections with ids image_banner_top and image_banner_bottom).
• Block type: Defined in the section schema's blocks array; each block entry may allow nested blocks and block_order.
• order: Top-level array listing section instance keys in render order.
• block_order: Per-level array listing block instance keys under that parent.

Sources