Skip to content
ByteScaffold Logo, Shopware AgenturByteScaffoldShopware Agency
Shopware 6.7 Troubleshooting

Shopware Plugin wird nicht geladen: custom/static-plugins und Composer

Nach einem Update oder Deployment fehlt ein Plugin in der Administration, obwohl der Ordner in custom/static-plugins liegt. Hier steht, was die Shopware-Dokumentation dazu festlegt und wie Sie die Ursache eingrenzen.

Hilfe bei Plugins anfragen Update-Service ansehen
Eine Hand setzt ein leuchtendes blaues Acrylmodul auf eine Platine, als Sinnbild einer Plugin-Architektur

Wer nach einem Update feststellt, dass Plugins aus custom/static-plugins nicht mehr auftauchen, vermutet schnell eine Änderung in Shopware 6.7. Eine solche Änderung konnten wir in den offiziellen Quellen nicht bestätigen. Die Entwicklerdokumentation von Shopware beschreibt einen anderen, länger geltenden Mechanismus, der dieselben Symptome erzeugt: Static Plugins werden über Composer verwaltet und nicht über die Administration.

Diese Seite fasst zusammen, was dazu dokumentiert ist, und gibt eine Reihenfolge, in der Sie die Ursache eingrenzen. Wenn Ihr Fall dabei nicht auftaucht, lohnt sich ein Blick in die Release Notes Ihrer Version.

Was die Dokumentation zu Static Plugins festlegt

Shopware kennt zwei Arten von Plugins im Projektordner. Projektspezifische Static Plugins liegen unter custom/static-plugins und werden in der Regel zusammen mit dem Projekt in Git versioniert. Verwaltete Plugins liegen unter custom/plugins und werden üblicherweise über die Administration installiert.

Laut Dokumentation erkennt die Shopware-Administration Static Plugins nicht. Sie müssen per Composer eingebunden werden, bevor sie installiert und aktiviert werden können. Das Beispiel der Dokumentation dafür ist „composer req <vendor>/<plugin-name>“. Ein Plugin, das nur im Ordner liegt, aber nicht in der composer.json steht, taucht deshalb nicht auf.

Nicht bestätigt: eine Änderung in Shopware 6.7, durch die custom/static-plugins nicht mehr gescannt wird. Wir haben in den Release Notes und der Dokumentation, die wir gelesen haben, keinen entsprechenden Eintrag gefunden.

Ursache eingrenzen: die Reihenfolge

  1. 1Liegt das Plugin im richtigen Ordner?Prüfen Sie, ob der Plugin-Ordner unter custom/static-plugins liegt und ob Ordnername und Plugin-Name zusammenpassen.
  2. 2Steht das Plugin in der composer.json?Static Plugins müssen per Composer eingebunden sein. Prüfen Sie, ob die composer.json das Plugin als Abhängigkeit führt und ob die composer.lock dazu passt.
  3. 3Wird der Ordner als Quelle bekannt gemacht?Ein üblicher Weg ist ein Path-Repository in der composer.json, das auf custom/static-plugins verweist. Dieser Weg wird auch in einem Issue zum Shopware-CLI beschrieben, in dem lokale Plugins beim Projekt-Upgrade Probleme machten.
  4. 4Wurde nach dem Update installiert und aktiviert?Nach Composer-Änderungen müssen Plugins neu erkannt, installiert und aktiviert werden. Prüfen Sie den Status in der Administration oder über die Konsole, und leeren Sie danach den Cache.
  5. 5Kommt der Code im Deployment an?Prüfen Sie, ob Ihr Deployment das Verzeichnis custom/static-plugins und die Composer-Dateien mitnimmt und ob der Ordner nicht per .gitignore ausgeschlossen ist. Ein lokal vorhandener Ordner fehlt sonst auf dem Zielsystem.

Wenn es nach einem Update plötzlich fehlt

  • Vergleichen Sie composer.json und composer.lock vor und nach dem Update. Ein Update-Werkzeug kann die Datei überschrieben haben.
  • Prüfen Sie, ob das Update mit einem Werkzeug wie dem Shopware-CLI erfolgte. Dort wurde berichtet, dass lokale Plugins beim Projekt-Upgrade Probleme machten, als Lösung wird ein Path-Repository genannt.
  • Lesen Sie die Log-Dateien im Verzeichnis var/log. Ein Plugin, das nicht geladen werden kann, hinterlässt dort meist einen Hinweis.
  • Deaktivieren Sie im Fehlerfall nicht einfach alle Plugins, sondern prüfen Sie einzeln, welches fehlt und ob es mit der Zielversion kompatibel ist.
Weiterlesen

Passende Leistungen und Leitfäden

Shopware 6.7 Update-ServiceWir prüfen vor dem Update Plugins, Composer-Einbindung und Kompatibilität und führen es auf einer Kopie aus.Update endet mit Error 500Zwei dokumentierte Ursachen für einen 500-Fehler nach dem Update, mit Lösungswegen.Shopware Plugin-EntwicklungIndividuelle Plugins, die Updates überstehen, gebaut gegen die öffentlichen APIs von Shopware.

Häufige Fragen zu Static Plugins

Verwaltete Plugins liegen in custom/plugins und werden üblicherweise über die Administration installiert. Static Plugins liegen in custom/static-plugins, sind projektspezifisch, werden in der Regel in Git versioniert und über Composer eingebunden.

Quellen

Stand: 24. Oktober 2026. Die Angaben fassen die öffentliche Dokumentation zusammen und ersetzen nicht die Prüfung Ihres Projekts. Details zur Einbindung hängen von Ihrer Projektstruktur und Ihrem Deployment ab.

Plugin lässt sich nicht laden?

Schreiben Sie uns Ihre Shopware-Version, die Projektstruktur und die Fehlermeldung. Wir melden uns innerhalb eines Werktags.

Hilfe bei Plugins anfragen Alle Leistungen