Shopify Custom HTML Section mit Liquid & CSS

shopify custom html

⏱ 12 Min. Lesezeit

Für viele Shops braucht es kein komplett neues Theme. Eine Shopify Custom HTML Section reicht oft, um Landingpages, Produktbereiche oder Kampagnenseiten mit HTML, Liquid und CSS sauber zu erweitern, ohne dein Theme in ein Archiv spontaner Entscheidungen zu verwandeln.

Der nützliche Weg ist klar: Struktur zuerst, Styling danach, Daten nicht hart codieren. Der chaotische Weg ist auch klar: irgendwo Code einfügen, live testen und später hoffen, dass niemand die Seite für einen zweiten Markt, ein zweites Template oder eine zweite Meinung anfassen muss.

Dunkles Analytics-Dashboard neben der Planung einer Shopify Custom HTML Section

Was du vor dem Start brauchst

Du brauchst Zugriff auf den Shopify Theme Editor, im Idealfall Berechtigungen für den Code-Editor und immer eine Theme-Kopie. Direkt im Live-Theme zu arbeiten ist mutig auf die falsche Art.

Du brauchst außerdem einen klaren Umfang. Wenn es nur um eine einzelne Kampagnenseite geht, reicht meist ein leichter Aufbau. Wenn wiederverwendbare Abschnitte, saubere Liquid-Architektur und langfristige Wartbarkeit wichtig werden, ist das eher ein Fall für eine Agentur für Shopify Theme-Entwicklung. Wenn vor allem Struktur und Nutzerführung schwächeln, ist das eher ein Thema für Shopify Website Design.

  • Kenntnisstand: Grundverständnis für HTML und CSS sowie genug Liquid, um Variablen und Bedingungen zu erkennen.
  • Zeitbedarf: 30 Minuten für einen simplen Block, 2 bis 4 Stunden für einen pflegbaren Abschnitt mit Metafields.
  • Sinnvolle Einsatzfälle: Landingpages, Kampagnen, Content-Blöcke, Produktbereiche und individuellere Seitensektionen.

Shopify Liquid kompakt: die Syntax, die du für eigene Sections brauchst

Liquid ist die Template-Sprache von Shopify. Sie läuft auf dem Server, setzt Shop-Daten in dein HTML ein und schickt fertiges HTML an den Browser. Für eigene Sections reichen drei Bausteine:

Baustein Syntax Beispiel Wofür
Objekte {{ … }} {{ product.title }} Gibt Shop-Daten aus
Tags {% … %} {% if product.available %} … {% endif %}, {% for block in section.blocks %} Logik: Bedingungen, Schleifen, Variablen mit assign oder capture
Filter {{ … | filter }} {{ product.price | money }} Formatiert die Ausgabe; mehrere Filter laufen von links nach rechts

Alle Objekte, Tags und Filter stehen in der offiziellen Liquid-Referenz von Shopify (Englisch). Liquid rendert nur beim Laden der Seite; Tabs, Slider oder ein Warenkorb-Update ohne Neuladen brauchen JavaScript.

Schritt 1 – Die richtige Shopify custom section wählen

Die erste Entscheidung ist keine Codefrage. Du wählst zuerst das kleinste Werkzeug, das die Aufgabe wirklich löst. Shopify gibt dir mehrere Wege, und sie sind nicht austauschbar.

Custom Liquid passt für kleine, eher statische Layout-Anpassungen. Ein eigener Abschnitt ist besser, wenn Inhalte oder Einstellungen später im Theme Editor gepflegt werden sollen. In der Theme-Architektur von Shopify (Englisch) sind Sections Liquid-Dateien, die Händler anpassen und in mehreren Templates wiederverwenden können. Metafields sind die sauberste Wahl, wenn Inhalte strukturiert, wiederverwendbar oder produktbezogen sein müssen.

Option Geeignet für Größter Vorteil Größte Schwäche
Custom Liquid Schnelle Layout-Anpassungen und leichter Shopify custom code Ohne neue Section-Datei umsetzbar Schwach bei wiederverwendbaren Einstellungen
Eigener Abschnitt Wiederverwendbare Layouts mit pflegbaren Feldern Langfristig sauberer Aufbau Benötigt Code-Zugriff
Metafields Strukturierte Inhalte, Produktdaten, wiederkehrende Blöcke Skaliert besser über Produkte und Märkte Braucht etwas Planung vor dem Aufbau

Shopify App durch eigenen Code ersetzen?

Dieselbe Abwägung gilt, wenn du eine App loswerden willst, die nur statische Inhalte ausgibt: Trust-Badges, Tabs mit Zusatzinfos, eine Ankündigungsleiste oder eine einfache Größentabelle. Solche Widgets lassen sich oft mit einer eigenen Section und ein paar Metafields nachbauen. Dann fallen App-Abo und Zusatz-Skript weg.

Sammelt die App dagegen Bewertungen, rechnet Abos ab oder synchronisiert Daten, ist das kein Theme-Code mehr. Welche Apps sich ersetzen lassen, beschreibt unser Leitfaden Shopify App ersetzen mit Custom Code. Welche Apps den Shop bremsen, zeigt der Artikel zur Shopify App Performance.

Entwickler bearbeitet Liquid und Shopify HTML/CSS in einem dunklen Workspace

Schritt 2 – Erst ein Seiten-Template anlegen, dann das Layout anfassen

Leg zuerst ein eigenes Template an. So bleibt dein Test sauber isoliert, und du verhinderst, dass eine einzelne Aktionsseite plötzlich dieselben Änderungen wie alle Standardseiten erbt. Shopify überrascht gern. Du musst es nicht zusätzlich ermutigen.

Dupliziere das passende Page-Template, vergib einen klaren Namen und weise es nur der Seite zu, die du anpassen willst. Das ist der Unterschied zwischen einer kontrollierten Umsetzung und einer späteren Spurensuche im Theme.

Schritt 3 – Shopify Custom HTML Section mit Liquid aufbauen

Beginne mit einem simplen, lesbaren Muster. Guter Shopify custom code sieht meist unspektakulär aus. Genau das ist der Punkt. Er ist nachvollziehbar, stabil und lässt sich erweitern, ohne dass der nächste Bearbeiter erst detektivisch werden muss.

Eine Shopify Custom HTML Section sollte sauberes Markup ausgeben, eindeutige Klassen haben und Logik nur dort nutzen, wo sie wirklich nötig ist. Kompletten HTML-Seitencode in einen kleinen Block zu kippen wirkt zuerst schnell. Später wirkt es vor allem wie eine Rechnung.

Einfaches Liquid-Muster

<section class='custom-page-hero'>
  <h2>{{ page.title }}</h2>
  <div class='custom-page-hero__content'>
    {{ page.content }}
  </div>
</section>

Warum das sauber ist

  • Es nutzt vorhandene Seitendaten statt doppelten Text.
  • Es trennt Inhalt, Struktur und Styling sauber genug.
  • Es lässt sich später auf Metafields umstellen, ohne alles neu zu bauen.

⚠️ Warnung

Die Suchanfrage „Shopify HTML Code einfügen“ klingt praktisch, führt aber oft in die falsche Richtung. Wenn du sichtbaren Storefront-Inhalt bauen willst, gehört der Code in Theme, Section oder Custom Liquid. Dateien hochzuladen ist etwas anderes.

HTML-Code in Shopify einfügen: vorhandenes HTML in Liquid umwandeln

Fertigen HTML-Code, etwa aus einem Page Builder oder dem alten Shop, musst du nicht neu schreiben: Gültiges HTML ist in einer Liquid-Datei bereits gültige Ausgabe. Einen pflegbaren Abschnitt macht daraus aber erst deine Entscheidung, welche Teile editierbar werden und welche wegfallen, und die nimmt dir auch ein Konverter-Tool nicht ab. Geh in vier Durchgängen vor:

  1. Dokument-Hülle entfernen. <html>, <head>, <body>, Header und Footer liefert das Theme-Layout.
  2. Hart codierte Texte ersetzen. Nutze Liquid-Objekte, wo der Inhalt schon existiert, zum Beispiel {{ product.title }}, Section-Einstellungen für Texte, die das Team ändern soll, und Metafields für strukturierte Daten.
  3. CSS eingrenzen. Stell jedem Selektor die Wrapper-Klasse voran und streich globale Resets.
  4. Doppelte Assets entfernen. Wirf Skripte und Schriften raus, die das Theme ohnehin lädt.

Minimale Section-Datei

<div class='promo-{{ section.id }}'>
  <h2>{{ section.settings.heading }}</h2>
  <div>{{ section.settings.text }}</div>
</div>

{% schema %}
{
  "name": "Promo-Text",
  "settings": [
    { "type": "text", "id": "heading", "label": "Überschrift" },
    { "type": "richtext", "id": "text", "label": "Text" }
  ],
  "presets": [{ "name": "Promo-Text" }]
}
{% endschema %}

Was die Umwandlung bringt

  • Im Ordner sections gespeichert, erscheint der Abschnitt dank presets im Theme Editor unter „Abschnitt hinzufügen“.
  • section.id hält die Wrapper-Klasse eindeutig, wenn du den Abschnitt zweimal einfügst.
Laptop mit Shop-Seite während eine Shopify custom section geplant wird

Wenn die Struktur größer wird, hilft Skalum beim sauberen Aufbau.

🎨

Shopify Theme Entwicklung

Für wiederverwendbare Sections, saubere Liquid-Architektur und Themes, die nach dem Launch editierbar bleiben.

Mehr erfahren →
💻

Shopify Website Design

Für Landingpages und Seitenstrukturen, bei denen nicht mehr Code, sondern bessere UX fehlt.

Mehr erfahren →
🎯

Conversion-Rate-Optimierung Audit

Für Seiten, die technisch hübsch sind, aber an den falschen Stellen weiter Umsatz verlieren.

Mehr erfahren →

Schritt 4 – Mit Custom CSS Shopify-Seiten pflegbar stylen

CSS sollte Gestaltung steuern, nicht schlechte Struktur retten. Style erst, wenn das Markup steht. Sonst verbringst du die Hälfte der Zeit damit, Selektoren zu reparieren, die nie hätten entstehen sollen.

Halte seitenbezogene Regeln innerhalb einer klaren Wrapper-Klasse. Globales CSS gehört nur dorthin, wo die Änderung wirklich shopweit gelten soll. Genau diese Trennung verhindert die klassische Frage: „Warum ist jetzt der Button auf der Startseite verrutscht?“

  • Nutze für jeden benutzerdefinierten Abschnitt eine eindeutige Wrapper-Klasse.
  • Style keine nackten Elemente wie h2 oder p global, wenn es nur um eine Seite geht.
  • Bleib bei Abständen, Farben und Typografie im System des aktiven Themes.

Shopify CSS bearbeiten: wo dein CSS hingehört

Wer in Shopify CSS bearbeiten will, hat ohne Code-Editor drei Orte mit eigenen Regeln (Quellen: Shopify Hilfe-Center zu benutzerdefiniertem CSS und Shopify-Doku zu Input Settings, Stand: Oktober 2026). Für dauerhafte Styles eigener Abschnitte bleibt die Section-Datei im Code-Editor der beste Ort.

Ort Was er annimmt Grenze Gut für
Custom CSS eines Abschnitts (Theme Editor, unten in den Abschnittseinstellungen) Nur CSS, automatisch auf diesen Abschnitt begrenzt; At-Rules nur @media, @container, @layer und @supports 500 Zeichen Kleine Korrekturen an einem bestehenden Abschnitt
Custom CSS in den Theme-Einstellungen CSS für das ganze Theme; kein @import, @charset oder @namespace 1.500 Zeichen Globale Kleinigkeiten, etwa Button-Radius oder Linkfarbe
Custom-Liquid-Block oder -Abschnitt HTML inklusive <style>-Element plus Liquid, aber ohne Theme-Datei-Tags wie {% stylesheet %}, {% javascript %} oder {% schema %} 50 KB pro Feld Styles, die zu genau diesem Custom-Liquid-Inhalt gehören

Zwei Einschränkungen überraschen oft: Im Custom-CSS-Feld ist die Eigenschaft content nicht verfügbar, und du kannst das umschließende shopify-section-Element nicht ansprechen. Custom CSS greift außerdem nicht auf der Checkout-Seite. Wird das Feld zu knapp, gehören die Styles in ein <style>-Element im Custom-Liquid-Block oder in die Section-Datei. Änderungen im Code-Editor übernimmt Shopify bei einem Theme-Update nur, wenn sie nicht mit dem Update kollidieren; sonst musst du sie selbst übertragen. Notiere deshalb, welche Dateien du angefasst hast.

MacBook mit Liquid-Code und CSS für eine Custom-CSS-Shopify-Anpassung

Schritt 5 – Shopify custom items und Produkt-Metafields ergänzen

Hier entscheidet sich, ob dein Aufbau später skaliert oder nur heute funktioniert. Wenn Inhalte je Produkt, Markt oder Kampagne wechseln, ist hart codierter Text nur am ersten Tag bequem.

Nutze Shopify custom fields und Metafelder für strukturierte Inhalte: Vorteile, Spezifikationen, Zusatzinfos, Lieferhinweise, Kampagnenblöcke oder FAQ-Snippets. Wenn Daten aus anderen Systemen kommen oder synchronisiert werden sollen, bewegt sich das Thema schnell in Richtung Shopify App-Entwicklung.

💡 Pro-Tipp

Behandle Liquid als Ausgabeschicht, nicht als Ablageort. Wiederkehrende Inhalte gehören in Metafields. Dann rendert dein Abschnitt die Daten, statt sie einzuschließen. Das ist besser für Händler, Übersetzungen und jeden, der das Theme in sechs Monaten anfassen muss.

Metafields in Liquid ausgeben

Ein Metafield sprichst du über product.metafields.namespace.key an, den Inhalt liefert .value. Bei Listen-Metafields ist .value ein Array für eine for-Schleife (Shopify Liquid-Referenz: metafield, Stand: Oktober 2026).

Metafields im Abschnitt

{% if product.metafields.custom.lieferhinweis != blank %}
  <p class='pdp-note'>
    {{ product.metafields.custom.lieferhinweis.value }}
  </p>
{% endif %}

<ul class='pdp-benefits'>
  {% for item in product.metafields.custom.vorteile.value %}
    <li>{{ item }}</li>
  {% endfor %}
</ul>

Worauf du achten solltest

  • Die if-Abfrage verhindert leere Container bei Produkten ohne Wert.
  • Für einfache Ausgaben reicht oft eine dynamische Quelle im Theme Editor, ganz ohne Code.

Schritt 6 – Seite testen, veröffentlichen und debuggen

Prüf die Seite auf Desktop und mobil, bevor sie live geht. Kontrolliere Abstände, Überschriften, leere Zustände, bedingte Liquid-Ausgaben und die Template-Zuweisung. Leere Felder sind oft der Moment, in dem ein sauberes Demo plötzlich sehr still wird.

Die Überschriften verdienen einen zweiten Blick, wenn die Seite ranken soll. Viele Themes geben den Seitentitel bereits als H1 aus, das Muster oben wiederholt ihn dann als H2. Öffne vor der Veröffentlichung den Quelltext und zähl die Überschriften.

Prüf auch die Ladezeit. Große Bilder, Inline-Skripte und zusätzliche Schriften in einem Custom-Abschnitt bremsen die Seite schnell aus. Wenn mehrere individuelle Seiten träge wirken, zeigt ein Shopify PageSpeed Audit, welche Abschnitte am meisten kosten.

Teste auch die langweiligen Dinge: Fokuszustände, Link-Ziele, Responsivität und ob jemand ohne Entwicklerblick die Inhalte später pflegen kann. Für punktuelle Umsetzungen, Debugging oder einen sauberen zweiten Blick ist ein Shopify Freelancer oft die sinnvollere Wahl als ein größeres Projekt.

Bleibt ein Abschnitt einfach leer, liegt es fast immer an den Daten: ein falscher Metafield-Schlüssel, ein leeres Feld oder ein Objekt, das auf diesem Template nicht existiert, etwa product auf einer normalen Seite.

Nach dem Launch zählt, ob die Seite verkauft. Eine technisch saubere Landingpage kann trotzdem Umsatz liegen lassen. Dann ist Conversion-Optimierung für Shopify der nächste Hebel, nicht noch mehr Code.

Häufige Fehler, die du vermeiden solltest

Die meisten Probleme sind keine technischen Meisterwerke. Es sind gewöhnliche Abkürzungen mit übertriebenem Selbstvertrauen.

  • Kompletten HTML-Seitencode in einen kleinen Block kopieren: Das funktioniert kurz und kollidiert dann mit Theme-Stilen, Selektoren und Responsivität.
  • Inhalte hart codieren: Das spart heute Minuten und kostet später jede Änderung doppelt.
  • Globales CSS für lokale Änderungen verwenden: Ein einziger Selektor reicht, und plötzlich verschiebt sich Layout an Stellen, die nichts mit der Seite zu tun haben.
  • Ohne Template-Kopie arbeiten: Du denkst, du änderst eine Seite. In Wirklichkeit änderst du die Regeln für viele.
  • Liquid ins Schema schreiben: Der {% schema %}-Tag muss reines JSON enthalten. Liquid darin wird nicht ausgeführt, ein zweiter Schema-Tag erzeugt einen Syntaxfehler.

Fazit

Eine gute individuelle Shopify-Seite ist nicht die komplizierteste. Sie ist die Seite, bei der Inhalt, Struktur und Styling sauber getrennt bleiben, damit spätere Änderungen nicht nach Notfall aussehen. Starte mit dem kleinsten passenden Ansatz, schieb wiederkehrende Daten in Metafields und halte CSS lokal. Wenn daraus kein schneller Eingriff mehr wird, sondern eine belastbare Architektur, ist eine Agentur für Shopify Theme-Entwicklung der vernünftige nächste Schritt.

Wenn du dafür Unterstützung suchst: Als Shopify Agentur bauen wir eigene Sections so, dass dein Team sie danach selbst im Theme Editor pflegen kann.

Du willst die Seite sauber umsetzen, nicht nur irgendwie live bekommen?

🎨

Shopify Theme Entwicklung

Für wiederverwendbare Sections, saubere Liquid-Struktur und Seiten, die nicht beim nächsten Update kippen.

Mehr erfahren →
👤

Shopify Freelancer

Für fokussierte Umsetzungen, Fehlersuche und punktuelle Shopify-Aufgaben ohne unnötigen Projektballast.

Mehr erfahren →
📱

Shopify App Entwicklung

Für Integrationen, dynamische Inhalte und Datenflüsse, die mit Theme-only-Lösungen zu eng werden.

Mehr erfahren →
FAQ

Frequently Asked Questions

Ja, aber sauber wird es erst über einen Custom-Liquid-Block oder einen eigenen Abschnitt. So bleibt dein Shopify custom code im Theme-System, lässt sich besser stylen und später leichter pflegen. Reines Copy-paste von fremdem HTML wirkt zwar schnell, macht Änderungen später aber unnötig mühsam.

Custom Liquid ist schneller für kleine Layout-Anpassungen und einzelne Inhalte. Ein eigener Abschnitt ist sinnvoller, wenn Händler Einstellungen pflegen, Blöcke wiederverwenden oder Inhalte sauber strukturieren sollen. Sobald eine Seite wächst, ist ein Abschnitt meist stabiler als eine Sammlung einzelner Shopify custom liquid codes.

Meist solltest du gar keine komplette HTML-Datei für die Storefront hochladen. Shopify Files sind besser für öffentliche Assets oder Downloads gedacht. Wenn der Inhalt auf der Seite sichtbar gerendert werden soll, baust du ihn mit Liquid, Sections und Shopify HTML/CSS direkt im Theme auf.

Ja. Viele Themes bieten benutzerdefiniertes CSS direkt im Theme Editor an, global in den Theme-Einstellungen oder lokal auf Abschnittsebene. Für reine Design-Anpassungen ist das meistens der sicherste Weg. In Theme-Dateien solltest du erst eingreifen, wenn Struktur oder Logik geändert werden müssen.

Ja, sobald Inhalte strukturiert oder wiederholt genutzt werden. Shopify custom fields halten Produktdaten, Kampagneninhalte und Zusatzinformationen getrennt vom Template-Code. Das vereinfacht Updates, reduziert Kopierfehler und gibt deinem Team eine Möglichkeit, Inhalte zu pflegen, ohne jedes Mal Liquid-Dateien zu öffnen.

Nicht automatisch. Kleine, saubere Liquid-Ausgaben sind selten das eigentliche Performance-Problem. Meist bremsen unnötige Apps, große Medien, schlechtes Frontend-JavaScript oder aufgeblähte Layouts. Halte die Logik schlank, binde Assets gezielt ein und prüf, ob das gewünschte Ergebnis nicht mit weniger Code erreichbar ist.

Nein. Eigene Abschnitte und viele Anpassungen lassen sich auch auf regulären Shopify-Plänen umsetzen, solange dein Theme modern genug ist und du Zugriff auf den Theme-Code hast. Shopify Plus wird erst relevant, wenn deutlich größere Plattform-, Checkout- oder Organisationsanforderungen dazukommen.

Dann, wenn die Änderung mehrere Templates berührt, Metafields sauber aufgebaut werden müssen oder ein Fehler das Live-Theme riskant macht. Für kleine Schritte reicht oft ein gutes Shopify Liquid Tutorial. Für produktive Änderungen ist ein erfahrener Shopify Freelancer meist billiger als spätere Reparaturen.

Ohne Code öffnest du im Theme Editor entweder die Theme-Einstellungen (Custom CSS für das ganze Theme, bis 1.500 Zeichen) oder einen einzelnen Abschnitt (Custom CSS nur für diesen Abschnitt, bis 500 Zeichen). Größere oder dauerhafte Styles gehören in die Section-Datei oder eine CSS-Datei im Code-Editor, am besten in einer Theme-Kopie. Stand: Oktober 2026, laut Shopify Hilfe-Center.

Ja. Shopify beschreibt das Custom-Liquid-Feld als Feld, das HTML und eingeschränktes Liquid annimmt, also wird ein normales

-Element mit ausgegeben. Theme-Datei-Tags wie {% stylesheet %}, {% javascript %} oder {% schema %} funktionieren dort nicht, und der Inhalt darf 50 KB nicht überschreiten (Stand: Oktober 2026).