Shopware 6 theme:compile: Wann muss das Theme neu kompiliert werden?

Theme angepasst, aber im Shop ändert sich nichts? Dann fehlt theme:compile

Was die Theme-Kompilierung in Shopware 6 macht und wann du sie brauchst

Du änderst eine Farbe, eine Schrift oder einen Abstand am Theme, aber im Shop sieht alles aus wie vorher. Das ist kein Fehler, sondern Absicht: Shopware liefert das Aussehen aus einer fertig kompilierten Datei aus. Solange du das Theme nicht neu kompilierst, bleibt die alte Version sichtbar.

In diesem Artikel klären wir, was theme:compile in Shopware 6 eigentlich macht, wann du dein Theme neu kompilieren musst und wie du das machst. Verständlich erklärt, mit dem Blick darauf, was es für deinen Shop bedeutet.

Was macht die Theme-Kompilierung?

Von SCSS zu fertigem CSS

Das Theme bestimmt, wie dein Shop aussieht: Farben, Schriften, Abstände, das ganze Erscheinungsbild. Geschrieben wird das nicht direkt als fertiges CSS, sondern in SCSS, einer komfortableren Schreibweise mit Variablen und Strukturen. Der Browser versteht aber nur fertiges CSS.

Genau hier kommt die Theme-Kompilierung ins Spiel: Sie übersetzt dein SCSS in das CSS, das der Shop am Ende ausliefert. Der Befehl theme:compile stößt diese Übersetzung an. Erst danach sieht der Besucher deine Style-Änderungen.

Ineinanderfließende Farben als Bild für SCSS, das zu CSS kompiliert wird

Wann musst du das Theme neu kompilieren?

Immer dann, wenn sich das Aussehen ändert

Neu kompilieren musst du, sobald sich etwas an den Styles selbst ändert: nach Anpassungen am SCSS, nach geänderten Theme-Variablen wie Farben oder Schriften oder nachdem du einem Verkaufskanal ein anderes Theme zugewiesen hast.

Ein praktischer Unterschied: Wenn du Theme-Einstellungen direkt im Admin änderst und speicherst, stößt Shopware die Kompilierung automatisch an. Änderst du dagegen das SCSS im Code, passiert das nicht von allein, dann musst du selbst kompilieren.

Änderst du etwas an der theme.json, also der Theme-Konfiguration, brauchst du zusätzlich theme:refresh, damit die Änderung überhaupt erkannt wird.

Wie kompilierst du das Theme?

Über den Admin oder die Kommandozeile

Der einfachste Weg führt über den Admin: Wenn du die Theme-Einstellungen öffnest, etwas änderst und speicherst, kompiliert Shopware das Theme automatisch.

Wer Zugriff auf den Server hat, nutzt die Kommandozeile. Der zentrale Befehl ist:

bin/console theme:compile

Hast du die theme.json angepasst, lass vorher einmal die Konfiguration auffrischen:

bin/console theme:refresh

Und wie bei jeder solchen Änderung gilt: danach den Cache leeren, damit der Shop das neue CSS auch wirklich ausliefert.

Farbkarten als Bild für die Theme-Einstellungen

theme:compile oder Storefront build?

Wann reicht welcher Schritt

theme:compile

Reicht, wenn du nur am Aussehen drehst: Farben, Schriften, Abstände, SCSS. Der schnellste Weg für reine Style-Änderungen, ohne den ganzen Storefront neu zu bauen.

Storefront build

Nötig, wenn sich auch das JavaScript des Storefronts ändert, etwa durch ein neues oder aktualisiertes Plugin. Der Storefront build kompiliert das Theme gleich mit.

Stand: Dieser Beitrag bezieht sich auf Shopware 6.7.0.0. In neueren Versionen können sich einzelne Befehle oder Pfade unterscheiden.

Unsicher, ob kompilieren oder bauen?

Schreib uns, wir schauen gemeinsam drauf

Mail schreiben

Ob Theme, Build oder ein Shop, der Style-Änderungen nicht zeigt: Wenn du Hilfe mit deinem Shopware-6-Shop brauchst, melde dich. Wir klären mit dir, ob ein Kompilieren reicht oder ein Build dran ist.

Passt dazu