Shopware 6.7.12.1: llms.txt und die 6.7.12.0-Falle

Shopware 6.7.12.1: llms.txt und die 6.7.12.0-Falle

Vorsicht beim Klick auf das neueste Shopware-Update: Die Version 6.7.12.0 enthält kritische Fehler und sollte zugunsten der fehlerbereinigten Version 6.7.12.1 unbedingt übersprungen werden. Erfahren Sie hier, warum dieser Versionssprung für Ihre Datenbank-Performance entscheidend ist und wie Sie Ihren Shop mit den neuen AI Discovery Files fit für den Agentic Commerce machen.

Dennis Schwenker-Sanders 6 Min. Lesezeit

Am 7. Juli hat Shopware das Minor-Release 6.7.12 veröffentlicht. Wer heute in seiner Admin-Oberfläche ein Update sieht, sollte einen Moment innehalten, bevor er klickt. Version 6.7.12.0 lässt sich laut Shopwares eigener Release-Beschreibung nicht installieren, weil ein kritisches Problem kurz nach der Veröffentlichung entdeckt wurde. Wer bereits aktualisiert hat, sollte umgehend auf 6.7.12.1 weiterziehen.

Was Sie in 7 Minuten erfahren:

  1. Warum 6.7.12.0 übersprungen werden sollte und was der tatsächliche technische Grund dafür ist
  2. Was die neuen AI Discovery Files (llms.txt, agents.md) für Ihren Shop und Agentic Commerce bedeuten
  3. Welche Suchverbesserungen und Datenbank-Entlastungen in 6.7.12.1 stecken

Shopware ist für viele meiner Kundenprojekte der Kern-Stack, entsprechend genau schaue ich mir jedes Minor-Release an. 6.7.12 bringt neben der Installations-Falle einige Features, die für die Beratung von Handelskunden direkt relevant sind, allen voran die nativen AI Discovery Files.

Shopware 6.7.12: Die Kern-Neuerungen


Feature

Was es macht

Relevant für

AI Discovery Files (llms.txt, agents.md)

Opt-in Bereitstellung pro Sales Channel für KI-Suchsysteme

Agentic-Commerce-Vorbereitung

Suchfeld parent.name

Varianten über Hauptprodukt-Namen auffindbar (Opt-in)

Shops mit vielen Produktvarianten

HTML-freier Beschreibungs-Auszug

Produktlisten laden Kurztext statt Volltext

Datenbank-Last bei großen Katalogen

Webhook-Rework (Feature-Flag)

DB-Outbox mit gestaffeltem Retry bis 4 Stunden

Integrationen mit externen Systemen

Shopware Payments

Native Zahlungslösung auf PayPal-Infrastruktur

DE/AT-Händler, unabhängig vom Minor-Release

6.7.12.0 nicht installieren. Shopware selbst stuft die Version als nicht installierbar ein. Wer bereits aktualisiert hat, sollte direkt auf 6.7.12.1 weiterziehen. Für selbst gehostete Shops kommt eine Twig-3.28-Inkompatibilität hinzu, die zusätzliche Composer-Konfigurationsänderungen erfordert.

Betrifft Sie das? Schnelltest in 30 Sekunden

Sofort handeln wenn: Sie bereits auf 6.7.12.0 aktualisiert haben. Der Weiterzug auf 6.7.12.1 ist dann keine Option, sondern die einzige Möglichkeit, den Shop wieder in einen sauberen Zustand zu bringen.

Vor dem Update prüfen wenn: Sie selbst hosten und noch nicht auf 6.7.12 sind. Die Twig-3.28-Kompatibilität sollte vor dem Produktiv-Update auf einer Staging-Umgebung getestet werden.

Kein akuter Handlungsbedarf wenn: Sie Shopware über einen verwalteten Hosting-Anbieter betreiben. Diese kümmern sich in der Regel automatisch um den korrekten Versionspfad.

Bereits auf 6.7.12.0 aktualisiert?

Ich helfe Ihnen, den Shop sauber auf 6.7.12.1 weiterzuziehen und die Twig-Kompatibilität für Ihre selbst gehostete Installation zu prüfen.

  • Shopware-Updates und Self-Hosted-Betreuung
  • Twig- und Composer-Kompatibilitätsprüfung
Kostenlosen Check anfragen →

⏱️ Antwort binnen 24 Stunden

Was tatsächlich hinter der 6.7.12.0-Falle steckt

Die offizielle Kommunikation von Shopware bleibt bei der allgemeinen Formulierung eines kritischen Problems. Wer sich die Backport-Commits für 6.7.12.1 auf GitHub anschaut, findet den konkreten technischen Grund: eine Kompatibilitätslücke mit Twig 3.28 sowie ein eingefrorener Container-Parameter-Bag bei veralteter Cache-Konfiguration. Beide Fixes sind als expliziter Backport in 6.7.12.1 gelandet.

# Backport-Fixes laut Shopware-Changelog für 6.7.12.1:
# fix(core): compatibility with Twig 3.28
# fix: Frozen container parameter bag with deprecated cache config

# Für Self-Hosted-Betrieb vor dem Update prüfen:
$ composer show twig/twig
$ composer why-not shopware/core 6.7.12.1

Was die Release-Notes nicht explizit ausformulieren: Wer in eigenen Themes oder Plugins Twig direkt anspricht, etwa über eigene Twig-Extensions oder Custom-Filter, sollte nach dem Update prüfen, ob diese noch sauber laufen. Twig-Versionssprünge sind selten komplett folgenlos für Custom-Code, der tief in die Twig-Internas eingreift.

KurzDer tatsächliche Grund für die 6.7.12.0-Sperre ist eine Twig-3.28-Inkompatibilität und ein Container-Parameter-Bag-Fehler bei veralteter Cache-Konfiguration. Beide sind in 6.7.12.1 gefixt und sollten bei Self-Hosted-Betrieb vor dem Update geprüft werden.

Was AI Discovery Files für Ihren Shop bedeuten

Sales Channels können jetzt eigene /llms.txt- und /agents.md-Dateien veröffentlichen. Beide Standards helfen KI-Suchsystemen und Shopping-Agenten dabei, einen Shop besser zu verstehen und zu wissen, wie sie mit ihm interagieren sollen. Die Funktion ist Opt-in und wird pro Sales Channel verwaltet, mit Vorschau-Funktion und der Möglichkeit, eigene Hinweise zu ergänzen, ohne die von Shopware bereitgestellten Standardinformationen zu ersetzen.

# AI Discovery Files: technischer Aufbau
# Die Dateien werden aus Twig-Templates gerendert,
# erweiterbar über die normale Shopware-Twig-Vererbung

# templates/storefront/llms.txt.twig (vereinfacht)
{% block llms_txt_content %}
{{ parent() }}
# Eigene Hinweise für KI-Systeme ergänzen,
# ohne den Shopware-Standardinhalt zu überschreiben
{% endblock %}

Für Handelskunden ist das ein konkreter Beratungsanlass. Die Frage "Ist Ihr Shop bereit für Agentic Commerce?" lässt sich jetzt technisch beantworten, nicht nur strategisch diskutieren. Wer heute schon KI-gestützte Produktsuchen und Shopping-Agenten als relevanten Vertriebskanal einordnet, kann die Discovery Files als frühen, risikoarmen Schritt aktivieren.

Kurzllms.txt und agents.md sind Opt-in, pro Sales Channel konfigurierbar und über Twig erweiterbar. Für Shops, die sich auf Agentic Commerce vorbereiten wollen, ist das ein risikoarmer erster Schritt ohne Breaking Changes am bestehenden Shop.

⚡ AI Discovery Files für Ihren Shop aktivieren?

Ich richte llms.txt und agents.md für Ihre Sales Channels ein und berate, welche Inhalte für Ihre Produktkategorien sinnvoll sind.

  • Shopware-Kernstack seit vielen Kundenprojekten
  • Agentic-Commerce-Beratung aus der Praxis
Setup besprechen →

⏱️ Antwort binnen 24 Stunden

📞 Oder direkt anrufen: 04481 - 9099658

Was die Suchverbesserungen konkret bringen

Lohnt sich parent.name für Ihren Katalog?

Das neue Suchfeld parent.name macht Produktvarianten über den Namen des Hauptprodukts auffindbar, unabhängig vom eigenen Variantennamen. Standardmäßig ist das Feld deaktiviert und muss in der Produktsuchkonfiguration aktiviert und im Ranking eingeordnet werden. Für Shops mit vielen ähnlich benannten Varianten, etwa Größen- oder Farbvarianten mit knappen Eigennamen, kann das die Trefferquote in der Storefront-Suche deutlich verbessern.

Was bringt der HTML-freie Beschreibungs-Auszug?

Produktlisten laden jetzt einen HTML-freien Kurz-Auszug der Beschreibung statt des kompletten Volltexts. Das reduziert die Datenbanklast spürbar, besonders bei Katalogen mit langen, formatierten Produktbeschreibungen, die bisher komplett für jede Listenansicht geladen wurden, obwohl nur ein Ausschnitt angezeigt wird. Für Shops mit mehreren tausend Produkten und entsprechend datenbanklastigen Kategorieseiten ist das eine spürbare Verbesserung ohne eigenes Zutun.

Ergänzend gibt es einen neuen sha256-Twig-Filter neben dem bestehenden md5-Filter, verbessertes Elasticsearch-Autocomplete und eine überarbeitete Thumbnail-Verarbeitung mit GD- und Imagick-Unterstützung.

Aus der Praxis

Was mir bei Shopware-Projekten mit großen Katalogen häufig begegnet: Kategorieseiten, die spürbar langsamer laden, sobald Produktbeschreibungen mit viel HTML-Formatierung gefüllt sind, obwohl die Listenansicht davon nur die ersten Zeilen zeigt. Der HTML-freie Auszug in 6.7.12.1 löst genau dieses wiederkehrende Performance-Problem auf Framework-Ebene, ohne dass eine eigene Custom-Lösung dafür gebaut werden muss.

Wie ich im Artikel zu Shopware Nexus und MCP beschrieben habe, treibt Shopware die Agentic-Commerce-Strategie über mehrere Releases konsequent voran. Die AI Discovery Files reihen sich als konkreter, sofort nutzbarer Baustein in diese Entwicklung ein.

Zusammenfassung

6.7.12.0 nicht installieren. Der tatsächliche Grund ist eine Twig-3.28-Inkompatibilität und ein Container-Parameter-Bag-Fehler. Direkt auf 6.7.12.1 gehen.

AI Discovery Files (llms.txt, agents.md) sind Opt-in, pro Sales Channel konfigurierbar und über Twig erweiterbar. Ein konkreter, risikoarmer Schritt für Shops, die sich auf Agentic Commerce vorbereiten.

Suchverbesserungen: parent.name für Variantensuche (Opt-in), HTML-freier Beschreibungs-Auszug für weniger Datenbanklast.

Shopware Payments läuft unabhängig vom Minor-Release, aktuell für DE und AT, mit BNPL über PayPal und Klarna.

Sie wissen, ob Ihr Shop bereit für das Update ist.

Update-Check, AI-Discovery-Setup oder Twig-Kompatibilitätsprüfung für Self-Hosted-Betrieb. Lassen Sie uns klären, was für Ihren Shop der richtige nächste Schritt ist.

  • Shopware-Updates und Kompatibilitätsprüfung
  • Agentic Commerce und AI Discovery Files
Nächsten Schritt klären →

Häufige Fragen

Was passiert, wenn ich bereits auf Shopware 6.7.12.0 aktualisiert habe?

Shopware empfiehlt, direkt auf 6.7.12.1 weiterzuziehen. Die Version enthält den Fix für die Twig-3.28-Inkompatibilität und den Container-Parameter-Bag-Fehler, die in 6.7.12.0 zum Problem führten. Ein Downgrade ist nicht der empfohlene Weg, der Weiterzug auf den Patch-Release schon.

Muss ich llms.txt und agents.md aktivieren?

Nein, beide Dateien sind Opt-in und standardmäßig deaktiviert. Ob sich die Aktivierung lohnt, hängt davon ab, wie relevant KI-gestützte Produktsuchen und Shopping-Agenten für die Zielgruppe eines Shops bereits sind oder in absehbarer Zeit werden. Die Aktivierung selbst ist risikoarm, weil sie keine bestehende Shop-Funktionalität verändert.

Was ist der Unterschied zwischen llms.txt und agents.md?

Beide Dateien richten sich an KI-Systeme, decken aber leicht unterschiedliche Zwecke ab. llms.txt ist als allgemeiner Standard für KI-Suchsysteme gedacht, um Inhalte einer Website strukturiert zusammenzufassen. agents.md richtet sich stärker an autonome KI-Agenten, die aktiv mit einer Website interagieren, etwa für Agentic-Commerce-Anwendungsfälle. Shopware unterstützt beide Standards parallel und lässt sie über Twig-Templates erweitern.

Betrifft die Twig-3.28-Inkompatibilität auch Cloud-gehostete Shopware-Shops?

Shopware weist die Twig-Inkompatibilität explizit für selbst gehostete Installationen aus, bei denen Composer-Abhängigkeiten eigenständig verwaltet werden. Bei Shopware Cloud oder verwalteten Hosting-Lösungen übernimmt der Anbieter in der Regel die Versionsabstimmung zwischen Shopware-Core und den Composer-Abhängigkeiten, sodass diese Prüfung nicht selbst durchgeführt werden muss.

Wann sollte ich den Webhook-Rework mit dem Feature-Flag aktivieren?

Der Webhook-Rework mit DB-Outbox und gestaffeltem Retry ist standardmäßig deaktiviert und über WEBHOOKS_REWORK aktivierbar. Sinnvoll ist die Aktivierung für Shops mit Integrationen zu externen Systemen, bei denen kurze Ausfälle wie DNS-Störungen oder Neustarts beim Empfänger nicht sofort zum endgültigen Fehlschlag der Zustellung führen sollen. Für Shops ohne kritische Webhook-Integrationen ist die Standardeinstellung ausreichend.

Artikel teilen: