Templates und Sections

Die JSON-Form der Templates, Bindings, Farbschemata je Section und alternative Templates.

Templates haben die Form von Shopify: Sections als Objekt plus order, Blöcke plus block_order.

templates/product.editorial.json
jsonc
{
  "name": "Produkt Editorial",        // Titel im Dashboard (bei Alternativen)
  "sections": {
    "main": {
      "type": "product-main",
      "settings": { "layout": "gallery-right", "background": "accent" },
      "blocks": {
        "title": { "type": "product-title", "settings": { "text": "{{ product.title }}" } },
        "buy":   { "type": "buy-box", "settings": {} }
      },
      "block_order": ["title", "buy"]
    },
    "story": {
      "type": "image-text",
      "settings": { "image": "assets/story.webp", "background": "muted" },
      "disabled": false
    }
  },
  "order": ["main", "story"]
}

#Regeln

  • background einer Section ist ihr Farbschema: default, muted, primary, accent, contrast.
  • "{{ pfad }}" wird zum Binding, z. B. product.title, product.description, product.calculatedPrice, editorial.subtitle, editorial.richtext, shop.deliveryTime. Bindings werden gegen den Seitenkontext geprüft (ein Produkt-Binding auf der Startseite ist ein Fehler).
  • "assets/<datei>" wird zur URL des hochgeladenen Bildes.
  • Die eigene Array-Form ("sections": [{ id, type, settings, blocks: [...] }]) wird ebenfalls akzeptiert.
  • Welche Sections, Blöcke und Einstellungen es gibt, zeigt der Editor; technisch sind es die BlockDefinitions in packages/block-registry und themes/default.

#Alternative Templates

product.<name>.json und collection.<name>.json werden beim Anwenden als zusätzliche Templates angelegt (theme-<handle>-<typ>-<name>) und lassen sich pro Produkt bzw. Kollektion zuordnen.

#Was beim Anwenden passiert

  1. Sicherung des aktuellen Designs in die Bibliothek („Sicherung vom …“).
  2. Theme-Einstellungen bekommen den gewählten Stil, das CSS sowie Name und Version.
  3. Mit „Vorlagen übernehmen“: Standard-Templates je Typ werden überschrieben und veröffentlicht (mit Versionseintrag), Alternativen angelegt oder aktualisiert.
  4. Die Storefront wird neu validiert – das Theme ist sofort live.

Zuletzt aktualisiert am 21. Oktober 2026