JSON Templates

Composing Pages from Sections

JSON templates replaced monolithic product.liquid files. Each template file maps section instance IDs to section types and settings. Merchants customize section order and settings in the theme editor without touching code.

{
  "sections": {
    "main": {
      "type": "main-product",
      "settings": {
        "enable_sticky_info": true,
        "gallery_layout": "thumbnail"
      }
    },
    "related": {
      "type": "related-products",
      "settings": {
        "heading": "You may also like",
        "products_to_show": 4
      }
    },
    "newsletter": {
      "type": "newsletter",
      "settings": {
        "heading": "Get course updates"
      }
    }
  },
  "order": ["main", "related", "newsletter"]
}

1. sections object — keys are unique instance IDs (any string you choose)
2. type — must match a filename in sections/ (without .liquid)
3. settings — default values; merchants override in the editor
4. order array — controls vertical section sequence on the page
5. Alternate templates: product.alternate.json → suffix 'alternate' in Admin

To create a landing page template, add templates/page.landing.json and assign it to a page in Admin → Pages → Theme template. Each alternate template can have a completely different section stack.