Shopware

Wie funktionieren Shopware Themes?

Shopware Themes steuern das visuelle Erscheinungsbild der Shopware-Storefront, also Layout, Typografie, Farben und Bilder. Ein Theme überschreibt Twig-Templates, ergänzt SCSS und JavaScript und definiert konfigurierbare Einstellungen, die in der Administration erscheinen. Zentrale Steuerdatei ist die theme.json. Themes werden je Sales Channel zugewiesen und basieren standardmäßig auf einem mitgelieferten Standard-Theme auf Bootstrap-5-Grundlage.

Ein Theme ist in Shopware kein eigener Erweiterungstyp, sondern wird als Plugin umgesetzt oder, in Cloud-Umgebungen, als App ausgeliefert. Damit Shopware es als Theme erkennt, implementiert es ein definiertes Theme-Interface. Anders als Plugins und Apps, die installationsweit wirken, greift ein Theme nur für die Sales Channels, denen es zugewiesen ist. Für ein reines Theme ist kein PHP-Code nötig.

Baustein	Rolle im Shopware-Theme
theme.json	Zentrale Konfiguration: definiert Einstellungsfelder, Einstiegspunkte für SCSS und Assets sowie die Kompilierungs-Reihenfolge
Twig-Templates	Steuern das HTML der Storefront; lassen sich über Theme-Vererbung gezielt überschreiben
SCSS / CSS	Styling; Einstiegspunkt ist standardmäßig die base.scss; wird über einen SASS-Compiler verarbeitet
JavaScript	Wird über Webpack gebaut, da der PHP-Compiler nur SCSS verarbeitet
Zuweisung	Pro Sales Channel über den Theme Manager; wirkt nur dort, nicht installationsweit

Stand: Juni 2026. Angaben auf Basis der offiziellen Shopware-Developer-Dokumentation. Details können sich je nach Shopware-Version unterscheiden.

Aufbau eines Shopware-Themes

Vereinfachtes Schema. Die theme.json bündelt die Bausteine, beim Theme-Compile entstehen die ausgelieferten Assets für die Storefront.

Welche Rolle spielt die theme.json?

Die theme.json ist die zentrale Konfigurationsdatei eines Shopware-Themes. In ihr werden Konfigurationsfelder definiert, die sich in Tabs, Blöcke und Sektionen gliedern und später in der Administration als Theme-Einstellungen erscheinen. Der technische Name eines Feldes ist zugleich der Schlüssel, über den der Wert im Theme oder in den SCSS-Dateien angesprochen wird. Darüber hinaus legt die theme.json fest:

den Einstiegspunkt für das SCSS, standardmäßig die base.scss,
die Reihenfolge, in der Styles kompiliert werden (style-Sektion),
die Pfade zu Assets, die beim Kompilieren kopiert werden.

Beim Ausführen des Theme-Compile werden die definierten Assets zusammen mit dem kompilierten CSS und JavaScript in ein öffentliches Theme-Verzeichnis geschrieben. So entsteht aus Konfiguration und Quelldateien die ausgelieferte Storefront.

Einordnung

Der häufigste Fehler bei Shopware-Themes ist, das Standard-Theme stark zu überschreiben, statt sauber zu vererben. Wer Templates kopiert statt gezielt zu erweitern, zahlt das bei jedem Shopware-Update mit Mehraufwand. Ein wartbares Theme nutzt die Vererbung konsequent und greift nur dort ein, wo es wirklich nötig ist. Das spart langfristig deutlich mehr als jede schnelle Anpassung am Anfang.

Philipp Foreman, Geschäftsführer onacy GmbH

Wie werden Twig, SCSS und JavaScript verarbeitet?

Die Storefront von Shopware nutzt Twig als Template-Sprache. Ein Theme kann einzelne Twig-Templates des Standard-Themes überschreiben oder ergänzen, gesteuert über die Theme-Vererbung. Für das Styling kommt SCSS zum Einsatz. Der Einstiegspunkt ist standardmäßig die base.scss, in der sich die Standard-Styles anpassen oder eigene Styles ergänzen lassen.

SCSS wird über einen SASS-Compiler in PHP verarbeitet. JavaScript dagegen kann der PHP-Compiler nicht übernehmen, dafür wird Webpack genutzt. Nach Änderungen muss das Theme kompiliert werden, damit CSS, JavaScript und Assets neu erzeugt werden. Das Standard-Theme baut auf Bootstrap 5 auf, was als gemeinsame Grundlage dient.

Wie hängen Themes mit Storefront und Erlebniswelten zusammen?

Das Theme bildet das technische Fundament der Storefront und legt fest, wie Layout, Farben und Typografie aussehen. Innerhalb dieses Rahmens werden Inhalte gepflegt. Konkrete Seiteninhalte gestalten Redakteure dann komfortabel über die Shopware Erlebniswelten, das Drag-and-Drop-CMS. Auch Produktvarianten werden im Theme-Rahmen dargestellt.

Ein gutes Theme ist also nicht nur Optik, sondern die Bühne, auf der Inhalte, Produkte und Erlebnisse zusammenkommen. Wie onacy Shopware-Storefronts technisch und gestalterisch aufbaut, zeigt die Seite zu unseren Shopware-Leistungen.

Häufige Fragen zu Shopware Themes

Was ist ein Shopware Theme einfach erklärt?

Ein Shopware Theme steuert das visuelle Erscheinungsbild der Storefront, also Layout, Typografie, Farben und Bilder. Es überschreibt Twig-Templates, ergänzt SCSS und JavaScript und definiert Einstellungen, die in der Administration erscheinen. Gesteuert wird das über die theme.json. Themes werden pro Sales Channel zugewiesen und basieren standardmäßig auf einem Standard-Theme auf Bootstrap-5-Grundlage.

Wofür ist die theme.json zuständig?

Die theme.json ist die zentrale Konfigurationsdatei eines Themes. Sie definiert die Theme-Einstellungen für die Administration, legt den Einstiegspunkt für das SCSS fest, bestimmt die Reihenfolge der Style-Kompilierung und benennt die Asset-Pfade. Beim Theme-Compile werden auf dieser Basis CSS, JavaScript und Assets erzeugt und in ein öffentliches Verzeichnis geschrieben.

Brauche ich PHP-Kenntnisse für ein Shopware Theme?

Für ein reines Theme ist laut Shopware kein PHP-Code nötig. Gearbeitet wird mit Twig für die Templates, SCSS für das Styling und JavaScript für Interaktion, gesteuert über die theme.json. PHP-Kenntnisse werden erst relevant, wenn ein Theme als Plugin um eigene Funktionen erweitert wird. Für reine Gestaltung reicht das Theme-Handwerkszeug aus.

Wie unterscheidet sich ein Theme von einem Plugin?

Ein Theme ist kein eigener Erweiterungstyp, sondern wird als Plugin umgesetzt oder in der Cloud als App ausgeliefert und implementiert ein Theme-Interface. Der wichtigste Unterschied: Ein Theme wirkt nur für die Sales Channels, denen es zugewiesen ist, während Plugins und Apps installationsweit greifen. Ein Theme verändert das Erscheinungsbild, ein Plugin kann zusätzlich Funktionen ergänzen.

Ein Theme, das Updates übersteht

Ein wartbares Shopware-Theme nutzt Vererbung statt Kopieren und bleibt so updatefähig. Im Erstgespräch ordnen wir ein, wie zukunftssicher Ihr aktuelles Theme aufgebaut ist und wo sich eine saubere Theme-Struktur langfristig auszahlt.

Erstgespräch vereinbaren

Mehr Kontext: Shopware-Leistungen und Shopware Erlebniswelten