How to Create a Custom Section in Shopify
Create a custom Shopify section from scratch: the section file, its schema, example HTML and CSS, and how to add it in the theme editor — kept update-safe.
Was eine eigene Shopify-Sektion ist, alle Wege, eine hinzuzufügen — Theme-Editor, Code oder App — und wie du verhinderst, dass deine Sektionen beim nächsten Theme-Update kaputtgehen.
Eine eigene Sektion ist der Weg, einen Shopify-Storefront über das Layout hinaus zu gestalten, das dein Theme mitbringt — ein Hero, ein Bewertungsraster, eine FAQ, eine Größentabelle, ein Upsell-Block. In einem Online-Store-2.0-Theme sind Sektionen die Einheit, die Händler im Theme-Editor hinzufügen, umsortieren und konfigurieren — und die Einheit, zu der Entwickler greifen, wenn ein Design etwas braucht, das das Theme nicht schon mitliefert.
Das ist der Hub für das gesamte Thema. Er erklärt, was eine Sektion wirklich ist, die drei Wege, eine hinzuzufügen, samt ihrer Kompromisse, das Theme-Update-Problem, das still und leise viel handgebaute Arbeit löscht, und wo es für deine konkrete Aufgabe weitergeht.
Eine Sektion ist ein wiederverwendbarer, in sich geschlossener Baustein einer
Seite. Technisch ist sie eine .liquid-Datei im sections/-Ordner deines
Themes, die Markup (Liquid und HTML) mit einem {% schema %}-Block verbindet.
Das Schema ist ein kleines Stück JSON, das den Namen der Sektion und ihre
bearbeitbaren Einstellungen deklariert — Textfelder, Bildauswahl,
Farbfelder und so weiter.
Genau dieses Schema lässt eine Sektion wie einen erstklassigen Teil von Shopify wirken. Sobald eine Sektion im Theme existiert, taucht sie im Menü „Sektion hinzufügen" des Theme-Editors auf. Ein Händler kann sie auf ein Template ziehen, ihre Einstellungen ausfüllen, sie umsortieren und ausblenden — alles, ohne Code anzufassen. Sektionen können außerdem Blöcke enthalten: kleinere, wiederholbare Elemente (eine einzelne Slide, eine FAQ-Zeile, ein Testimonial), die ein Händler innerhalb der Sektion hinzufügt und umsortiert.
Ein paar verwandte Begriffe lohnt es sich früh zu trennen:
templates/product.json,
templates/index.json), die auflistet, welche Sektionen auf dieser Seite
erscheinen und in welcher Reihenfolge.Es gibt drei praktische Routen zu einer neuen Sektion, und sie unterscheiden sich vor allem darin, wie viel Kontrolle du bekommst gegenüber dem, was später kaputtgehen kann.
Viele Themes enthalten bereits flexible Sektionen — oft eine „Custom Liquid"-, „Mehrspaltig"-, „Rich Text"- oder „Bild mit Text"-Sektion. Du fügst eine aus dem Editor hinzu, konfigurierst ihre Einstellungen, und bist fertig. Das ist der schnellste Weg und braucht keine Entwicklung, aber du bist auf das beschränkt, was die eingebauten Sektionen des Themes hergeben. Für ein wirklich neues Layout reichen die Einstellungen meist nicht weit genug.
Für volle Kontrolle schreibst du die Sektion selbst: eine neue
.liquid-Datei in sections/, mit deinem Markup und einem {% schema %}, das
genau die Einstellungen definiert, die du willst. Das ist die flexibelste Route
und die, die die meisten Tutorials lehren. Die Schritt-für-Schritt-Anleitung
findest du hier:
So erstellst du eine eigene Sektion in Shopify.
Der Haken ist die Zugehörigkeit: Die Datei lebt nun in deinem Theme. Das ist in Ordnung, bis du das Theme aktualisierst oder ersetzt — genau das Problem, das weiter unten behandelt wird.
Eine Sektion kann auch von einer Shopify-App als App-Block oder als app-eingebettete Sektion geliefert werden, gerendert über eine Theme App Extension. Du installierst die App, und ihre Sektionen erscheinen im Editor neben denen des Themes. Weil das Markup in der App lebt — nicht in deinen Theme-Dateien — wird es beim Theme-Update nicht angefasst. Genau diesen Mechanismus nutzt SectionGuard, und er wird ausführlich erklärt in Theme App Extensions von Shopify, erklärt.
Hier ist das Problem, das entscheidet, ob deine Arbeit überlebt. Wenn du eine
Sektion hinzufügst, indem du Theme-Dateien bearbeitest — eine neue
.liquid-Datei oder eingefügtes Markup in einer „Custom Liquid"-Box —, wird
dieser Code Teil genau dieser Theme-Version. Shopify führt deine Änderungen
nicht in ein Theme-Update zusammen. Wenn du eine neue Version des Themes
installierst (oder das Theme komplett wechselst), veröffentlicht das Update eine
frische Kopie der Theme-Dateien, und alles, was du der alten Kopie von Hand
hinzugefügt hast, wird nicht übernommen.
In der Praxis heißt das: Ein Shop-Betreiber kann Stunden mit dem Bau einer eigenen Sektion verbringen, das Theme Monate später aktualisieren, um einen Bugfix oder ein neues Feature zu bekommen — und die Sektion ist weg. Die Sektions-Einstellungen, die ein Händler im Editor konfiguriert hat, werden pro Template gespeichert, also können auch die verloren gehen, wenn die Sektion, auf die sie sich bezogen, nicht mehr existiert.
Es gibt zwei ehrliche Wege, das zu vermeiden:
Keine der beiden Routen ist im Abstrakten „die richtige". Ein einmaliger Kniff an einem Theme, das du selten anfasst, kann ruhig von Hand geschrieben werden. Eine Sektion, auf die du über Theme-Wechsel hinweg angewiesen bist, ist sicherer aus einer App gerendert. Der ehrliche Vergleich legt offen, was ein Theme-Update übersteht und was eine App-Deinstallation übersteht, damit du mit offenen Augen wählen kannst.
Die Cluster-Guides unten decken jede Aufgabe Schritt für Schritt ab. Beginne mit der, die zu dem passt, was du gerade tust:
Wenn deine eigentliche Frage lautet „Wie behalte ich diese Sektionen beim Theme-Wechsel?", lies Theme App Extensions zusammen mit dem Vergleich — gemeinsam erklären sie, warum app-gerenderte Sektionen Updates überleben, die Theme-Dateien überschreiben, und wo SectionGuard hineinpasst.
Schritt-für-Schritt-Anleitungen und Erklärungen zu diesem Thema.
Create a custom Shopify section from scratch: the section file, its schema, example HTML and CSS, and how to add it in the theme editor — kept update-safe.
Add a section to any Shopify page from the theme editor: pick the template, insert and reorder the section, configure it, and reuse it across pages.
Add a custom section to your Shopify homepage from the theme editor, order it around the hero, and configure it — plus how to keep it on a theme update.
Add a section to the Shopify product page: the product template, app blocks in the product form, reading product data and metafields, and update-safety.
Add custom HTML to a Shopify page: the built-in Custom Liquid section, a reusable HTML section with a schema, escaping pitfalls, and update-safety.
Three ways to style a Shopify section — a {% stylesheet %} block, an assets file, and theme color settings — scoped so it never leaks into the rest of the theme.
How to use the Custom Liquid section, add a script tag, and run JavaScript in a Shopify section without breaking the theme, leaking scope, or slowing the page.
A reference for the Shopify section schema: settings, blocks, presets, and limits — with the exact JSON and how each field maps to the theme editor.
Add a product review section on Shopify — with a built-in reviews app, a metafield-driven Liquid section, or a review app block — kept update-safe.
Add an FAQ section on Shopify with a collapsible accordion — built from section blocks so merchants add and reorder questions, plus valid FAQ schema.
Add an order notes field at checkout, a delivery-notes box on the cart, or a note-taking section on a page in Shopify — with the right method for each.
Add an upsell or cross-sell section to a Shopify product page — from product-recommendations, hand-picked products, or an app block — with real section code.
SectionGuard rendert deine eigenen Sektionen über eine Theme App Extension — dein Theme bleibt sauber und voll aktualisierbar.
Kostenlos für bis zu 3 Sektionen · Keine Kreditkarte · Läuft auf OS 2.0 & Horizon.