Montag morgen, der Shop ist live, aber Kunden melden: “Die Suche zeigt keine Ergebnisse.” Sie prüfen selbst, tippen einen Produktnamen ein und bekommen eine leere Seite. Oder schlimmer: Die Suche liefert Ergebnisse, aber die falschen. Ein Bestseller taucht nicht auf, dafür steht Zubehör auf Platz eins.

Wenn die Shopware-Suche nicht funktioniert, liegt es fast immer an einer von acht Ursachen. Die gute Nachricht: Die meisten lassen sich ohne externen Entwickler beheben. Dieser Troubleshooting-Guide zeigt Ihnen, wo Sie anfangen und wie Sie systematisch vorgehen.

Ursache 1: Der Suchindex ist nicht aktuell

Das häufigste Problem und gleichzeitig das am einfachsten zu lösende. Shopware 6 nutzt Elasticsearch (oder ab Version 2.4.6 OpenSearch) als Such-Backend. Die Produktdaten liegen in einem separaten Index, nicht in der Shop-Datenbank. Wenn dieser Index nicht aktuell ist, findet die Suche Produkte nicht, die kürzlich hinzugefügt, geändert oder importiert wurden.

Symptome: – Neue Produkte tauchen nicht in der Suche auf – Geänderte Produktnamen oder Beschreibungen werden nicht gefunden – Nach einem Import fehlen Produkte in den Suchergebnissen

Lösung: Navigieren Sie zu Einstellungen → System → Caches & Indizes und klicken Sie auf “Suchindex aufbauen”. Alternativ per Konsole:

bin/console es:index

Richten Sie einen Cronjob ein, der den Index automatisch neu aufbaut. Mindestens einmal täglich, idealerweise nach jedem Produktimport.

Wichtig: Nach größeren Datenänderungen (Massenimport, Kategorieumstrukturierung, Plugin-Updates) sollte der Index immer manuell neu aufgebaut werden. Ein inkrementelles Update reicht in diesen Fällen oft nicht.

Ursache 2: Elasticsearch ist nicht erreichbar oder falsch konfiguriert

Shopware 6 benötigt eine laufende Elasticsearch-Instanz. Wenn der Elasticsearch-Service nicht erreichbar ist, fällt die Suche entweder komplett aus oder wechselt auf eine langsamere Fallback-Suche (je nach Shopware-Version und Konfiguration).

Symptome: – Suche extrem langsam (>5 Sekunden) – Suche liefert gar keine Ergebnisse – Fehlermeldungen im Shopware-Log (“Connection refused”, “No alive nodes found”)

Lösung: Prüfen Sie den Status Ihrer Elasticsearch-Instanz:

curl -X GET "localhost:9200/_cluster/health"

Der Status sollte “green” oder “yellow” sein. “Red” bedeutet: Cluster hat Probleme, Indizes sind nicht verfügbar.

Prüfen Sie die Verbindungseinstellungen in der .env-Datei Ihres Shops:

SHOPWARE_ES_HOSTS="localhost:9200"
SHOPWARE_ES_ENABLED=1
SHOPWARE_ES_INDEXING_ENABLED=1
SHOPWARE_ES_INDEX_PREFIX="sw"

Bei Managed-Hosting-Anbietern liegt die Konfiguration oft im Hosting-Panel. Stellen Sie sicher, dass die URL, der Port und eventuelle Authentifizierungsdaten korrekt sind.

Ein weiterer Stolperstein: Nach einem Shopware-Update oder einem Server-Neustart startet Elasticsearch nicht automatisch. Prüfen Sie, ob der Service als systemd-Service konfiguriert ist und beim Booten automatisch gestartet wird. Bei Docker-basierten Setups: Ist der Elasticsearch-Container im docker-compose.yml mit restart: always konfiguriert?

Ursache 3: Produkte sind nicht für die Suche aktiviert

Shopware erlaubt es, Produkte gezielt aus der Suche auszuschließen. Wenn Produkte nicht auffindbar sind, prüfen Sie, ob sie überhaupt als “suchbar” markiert sind.

Symptome: – Einzelne Produkte werden nicht gefunden, obwohl sie aktiv und im Shop sichtbar sind – Ganze Produktgruppen fehlen in den Suchergebnissen

Lösung: Öffnen Sie das betroffene Produkt im Admin unter Katalog → Produkte. Prüfen Sie:

  1. Aktiv-Status: Ist das Produkt auf “Aktiv” gesetzt?

  2. Sichtbarkeit: Ist das Produkt im gewünschten Verkaufskanal sichtbar?

  3. Suchschlüsselwörter: Sind relevante Suchbegriffe hinterlegt?

Häufiger Fehler bei Varianten-Artikeln: Die Hauptvariante ist aktiv, aber einzelne Varianten sind deaktiviert oder keinem Verkaufskanal zugeordnet. Shopware indiziert nur Produkte, die aktiv und einem Verkaufskanal zugewiesen sind.

Ursache 4: Caching-Probleme

Shopware nutzt mehrere Cache-Ebenen: HTTP-Cache, Application-Cache und den Elasticsearch-Index. Wenn eine dieser Ebenen veraltete Daten ausliefert, kann die Suche falsche oder unvollständige Ergebnisse zeigen.

Symptome: – Suche zeigt veraltete Produktdaten (alter Preis, alter Name) – Änderungen werden erst nach Stunden sichtbar – Suche funktioniert im Admin, aber nicht im Storefront

Lösung: Cache vollständig leeren. Über die Admin-Oberfläche: Einstellungen → System → Caches & Indizes → Cache leeren. Über die Konsole:

bin/console cache:clear

Bei Nutzung eines Reverse-Proxy (Varnish, Cloudflare) muss auch dieser Cache geleert werden. Shopware sendet Cache-Invalidierungen, aber bei Fehlkonfigurationen kommen diese nicht an.

Tipp: Wenn Sie ein Problem debuggen, deaktivieren Sie temporär den HTTP-Cache (Einstellungen → System → Caches & Indizes → HTTP-Cache deaktivieren), um sicherzustellen, dass Sie nicht gecachte Ergebnisse sehen.

Ursache 5: Plugin-Konflikte

Such-Plugins, SEO-Plugins oder Performance-Plugins können die Shopware-Suche beeinflussen. Besonders problematisch: Plugins, die den Suchindex modifizieren, eigene Elasticsearch-Queries einschleusen oder die Storefront-Suchanzeige verändern.

Symptome: – Suche funktionierte vor einem Plugin-Update, danach nicht mehr – Fehlermeldungen im Log, die auf ein bestimmtes Plugin verweisen – Suche funktioniert nach Deaktivierung eines Plugins wieder

Lösung: Systematisch testen: Deaktivieren Sie alle Third-Party-Plugins und prüfen Sie, ob die Suche funktioniert. Wenn ja, aktivieren Sie die Plugins einzeln wieder, bis das Problem auftritt. So identifizieren Sie den Verursacher.

Achten Sie besonders auf: – Such-Erweiterungen (erweiterte Suche, Suggest-Plugins) – SEO-Plugins (können URL-Strukturen ändern) – Performance-Plugins (können Caching-Verhalten ändern) – Import-Plugins (können die Indexierung beeinflussen)

Nach dem Identifizieren: Plugin-Dokumentation prüfen, Entwickler kontaktieren oder nach einem Update suchen.

Praxis-Tipp: Vor jedem Plugin-Update ein Backup des Elasticsearch-Index erstellen. Manche Plugin-Updates ändern die Index-Struktur, und ein Rollback ohne Backup kann aufwändig werden. Dokumentieren Sie außerdem, welche Plugins die Suche beeinflussen. Bei drei oder mehr Such-relevanten Plugins steigt das Konfliktpotenzial erheblich.

Ursache 6: Zu restriktive Sucheinstellungen

Shopware 6 erlaubt feingranulare Konfiguration der Suche. Zu restriktive Einstellungen können dazu führen, dass die Suche zu wenige oder gar keine Ergebnisse liefert.

Symptome: – Suche findet nur bei exakten Treffern Ergebnisse – Teilbegriffe werden nicht erkannt – Suche liefert bei vielen Anfragen “Keine Ergebnisse”

Lösung: Prüfen Sie unter Einstellungen → Suche → Produktsuche:

Einstellung

Problem wenn zu restriktiv

Empfehlung

Minimale Suchlänge

Kurze Begriffe (“USB”, “LED”) werden ignoriert

Auf 2-3 Zeichen setzen

Suchfelder aktiv

Zu wenige Felder durchsucht

Name, SKU, Beschreibung, Hersteller aktivieren

Gewichtung

Beschreibungsfeld auf 0

Mindestens niedrig (100-200) gewichten

AND/OR-Logik

AND-Verknüpfung bei mehreren Wörtern

OR als Standard, AND nur für Pflichtfelder

Ein häufiger Konfigurationsfehler: Die Suche ist auf AND-Logik eingestellt. Das bedeutet: Alle Suchbegriffe müssen im Produkt vorkommen. Bei “rotes T-Shirt Baumwolle” findet die Suche nur Produkte, die alle drei Begriffe enthalten. OR-Logik liefert mehr Ergebnisse und ist für die meisten Shops die bessere Wahl.

Ursache 7: Performance-Probleme

Bei Shops mit 10.000+ Produkten und vielen gleichzeitigen Suchanfragen kann Elasticsearch an seine Grenzen stoßen. Das liegt selten an Elasticsearch selbst, sondern an der Server-Konfiguration.

Symptome: – Suche wird zu Stoßzeiten langsam (>2 Sekunden) – Timeouts bei komplexen Suchanfragen – Autosuggest reagiert verzögert

Lösung: Elasticsearch braucht ausreichend Arbeitsspeicher. Faustregel: Mindestens 2 GB Heap für kleine Shops, 4-8 GB für Shops mit 20.000+ Produkten.

Prüfen Sie den aktuellen Heap-Verbrauch:

curl -X GET "localhost:9200/_nodes/stats/jvm?human"

Weitere Performance-Hebel: – Indizes optimieren: Zu viele durchsuchte Felder verlangsamen die Suche. Beschränken Sie sich auf die relevanten. – Shards reduzieren: Shopware legt standardmäßig mehrere Shards an. Für Shops unter 100.000 Produkten reicht oft ein Shard. – Separate Hardware: Elasticsearch sollte idealerweise auf einem eigenen Server oder Container laufen, nicht auf dem Webserver.

Ursache 8: Fehlende oder falsch gewichtete Suchattribute

Selbst wenn die Suche technisch funktioniert, liefert sie schlechte Ergebnisse, wenn die Suchattribute nicht korrekt konfiguriert sind. Das ist kein technischer Fehler im engeren Sinne, aber für Kunden fühlt es sich an wie “die Suche funktioniert nicht”.

Symptome: – Suche findet Produkte, aber die Relevanz stimmt nicht – Zubehör und Ersatzteile ranken vor Hauptprodukten – Suche nach Artikelnummern liefert keine Treffer

Lösung: Unter Einstellungen → Suche → Produktsuche die Gewichtung anpassen:

Feld

Empfohlene Gewichtung

Begründung

Produktname

700-1000

Höchste Priorität

Produktnummer / SKU

700-900

Wichtig für B2B und Wiederkäufer

Hersteller

400-500

Markensuche abfangen

Kurzbeschreibung

200-300

Relevante Produktinfos

Beschreibung

100-200

Breit, aber niedrig gewichtet

Custom Fields

Nach Bedarf

Technische Spezifikationen

Der häufigste Fehler: Die Produktnummer/SKU ist nicht als Suchfeld aktiviert. Kunden, die gezielt nach Artikelnummern suchen, bekommen null Ergebnisse. Aktivieren und hoch gewichten.

Details zur optimalen Konfiguration finden Sie im ausführlichen Guide: Shopware Suche optimieren.

Troubleshooting: Schritt für Schritt vorgehen

Wenn Sie nicht wissen, welche der acht Ursachen bei Ihnen zutrifft, gehen Sie systematisch vor. Diese Reihenfolge spart am meisten Zeit:

Schritt 1: Cache leeren und Index neu aufbauen. Behebt die häufigsten Probleme in unter 5 Minuten. Immer als Erstes versuchen.

Schritt 2: Elasticsearch-Status prüfen. curl localhost:9200/_cluster/health. Wenn der Status “red” ist oder der Service nicht erreichbar, liegt hier das Problem.

Schritt 3: Shopware-Logs prüfen. Unter var/log/ finden Sie Shopware-Logs, die Elasticsearch-Fehler protokollieren. Suchen Sie nach “elasticsearch”, “search” oder “index”.

Schritt 4: Produkteinstellungen prüfen. Öffnen Sie ein betroffenes Produkt im Admin. Ist es aktiv? Im richtigen Verkaufskanal? Sind Suchschlüsselwörter hinterlegt?

Schritt 5: Plugins einzeln testen. Alle Third-Party-Plugins deaktivieren, Suche testen, einzeln reaktivieren. Zeitaufwändig, aber zuverlässig.

Schritt 6: Konfiguration reviewen. Sucheinstellungen, Feldgewichtungen und AND/OR-Logik prüfen.

Wenn nach diesen sechs Schritten das Problem weiter besteht, liegt es vermutlich an einem tiefergehenden Infrastruktur-Thema (Server-Konfiguration, Elasticsearch-Version, Netzwerk). In diesem Fall lohnt sich die Unterstützung durch einen Shopware-Entwickler oder das Hosting-Team.

Dokumentieren Sie jeden Schritt und sein Ergebnis. Wenn Sie am Ende externe Hilfe brauchen, spart eine saubere Dokumentation (“Index neu gebaut: Problem besteht weiterhin. Elasticsearch-Status: green. Plugin X deaktiviert: kein Effekt.”) dem Entwickler Stunden an Analyse.

Shopware 6 Suche konfigurieren: Best Practices

Unabhängig von akuten Problemen lohnt es sich, die Suchkonfiguration regelmäßig zu überprüfen. Diese Einstellungen bilden eine solide Basis:

  • Suchindex: Cronjob für tägliche Neuindexierung einrichten

  • Minimale Suchlänge: 2 Zeichen (für Abkürzungen wie “TV”, “PC”, “XS”)

  • Suchfelder: Produktname, SKU, Hersteller, Kurzbeschreibung aktiv

  • Gewichtung: Produktname und SKU am höchsten

  • Synonyme: Die 20-30 häufigsten Synonyme Ihres Sortiments hinterlegen

  • Stopwörter: Deutsche Stopwörter (“für”, “mit”, “und”) konfigurieren

Diese Konfiguration deckt die Grundlagen ab. Für eine detaillierte Anleitung mit Gewichtungstabellen und fortgeschrittenen Einstellungen lesen Sie den vollständigen Guide: Shopware Suche optimieren.

Wann die Shopware-Suche an ihre Grenzen stößt

Manche Probleme lassen sich nicht durch Konfiguration lösen. Sie sind strukturelle Grenzen des Keyword-Matchings.

Wenn Ihre Kunden beschreibend suchen (“leichtes Sommerkleid für Hochzeit”), Tippfehler machen (“Nkie Laufschuhe”) oder Synonyme verwenden, die Sie nicht manuell hinterlegt haben, wird die Shopware-Suche keine befriedigenden Ergebnisse liefern. Egal wie gut die Konfiguration ist.

In diesen Fällen braucht es eine Suche, die Sprache versteht, nicht nur Buchstaben abgleicht. Semantische Suche mit Hybrid LLM Search erkennt die Bedeutung hinter einer Suchanfrage. Sie versteht, dass “Geschenk für Hobbyköchin” ein Kochbuch oder ein Messerset sein könnte, auch wenn kein Produkt diesen Text enthält. Null-Ergebnis-Seiten gehören damit der Vergangenheit an.

Und da eine spezialisierte Suchlösung als entkoppelte Infrastruktur arbeitet, löst sie gleichzeitig mehrere der oben beschriebenen Probleme auf einmal:

  • Kein Elasticsearch-Cluster, den Sie selbst betreiben müssen. Ursachen 2 und 7 entfallen komplett.

  • Keine Belastung Ihres Shop-Servers. Die Suche läuft extern, Ihr Shop bleibt schnell.

  • Keine Abhängigkeit von Plugin-Kompatibilität. Die Integration erfolgt per API, nicht per Plugin.

  • Keine manuelle Synonympflege. Automatische Relevanzberechnung statt statischer Listen.

  • 100% cookieless. DSGVO-konform ohne CMP-Consent für die Suchfunktion.

“Seit wir BatteryIncluded einsetzen, sehen wir spürbare Verbesserungen: Bereits nach zwei Monaten stieg unsere Conversion Rate um 10 Prozent, und nach vier Monaten konnten wir einen Zuwachs von 19 Prozent verzeichnen.” B&W Handelsgesellschaft mbH

Häufige Fragen

Warum findet Shopware meine Artikel nicht?

Die häufigste Ursache: Der Suchindex ist nicht aktuell. Nach Produktänderungen, Importen oder Plugin-Updates muss der Index neu aufgebaut werden. Prüfen Sie außerdem, ob das Produkt aktiv ist, dem richtigen Verkaufskanal zugeordnet ist und die relevanten Suchfelder (Name, SKU) aktiviert und gewichtet sind.

Wie kann ich die Sucheinstellungen in Shopware 6 ändern?

Unter Einstellungen → Suche → Produktsuche finden Sie alle Konfigurationsmöglichkeiten: Suchfelder, Gewichtungen, minimale Suchlänge und Synonyme. Für Elasticsearch-spezifische Einstellungen (Fuzziness, Analyzer) sind Anpassungen über die .env-Datei oder Custom Modules nötig.

Wie kann ich die Suche in Shopware 6 optimieren?

Drei Hebel haben den größten Effekt: Erstens, Suchfelder richtig gewichten (Produktname und SKU am höchsten). Zweitens, Synonyme für die 20-30 häufigsten Begriffe Ihres Sortiments anlegen. Drittens, den Suchindex regelmäßig per Cronjob neu aufbauen. Für eine ausführliche Anleitung: Shopware Suche optimieren.

Wie kann ich die Suchergebnisse in Shopware 6 anpassen?

Über Boost-Faktoren und Gewichtungen in den Sucheinstellungen. Produkte mit hoher Marge oder hohem Lagerbestand können durch Boosting bevorzugt werden. Für erweiterte Anpassungen (eigene Ranking-Logik, personalisierte Ergebnisse) brauchen Sie entweder Custom-Plugins oder eine externe Suchlösung mit Merchandising-Funktionen.

Wie kann ich Shopware 6 mit Advanced Search erweitern?

Shopware bietet im Plugin-Store verschiedene Such-Erweiterungen an, die Autosuggest, erweiterte Filter oder Synonymverwaltung verbessern. Für echtes semantisches Verständnis, automatische Relevanzberechnung und cookieless AI Recommendations bieten spezialisierte E-Commerce-Suchlösungen einen größeren Funktionsumfang als Plugin-basierte Erweiterungen.

Checkliste: Shopware-Suche reparieren

Zum Abschluss die kompakte Checkliste für den Notfall:

  • Cache geleert (HTTP-Cache + Application-Cache)

  • Suchindex neu aufgebaut

  • Elasticsearch erreichbar und Status “green”/“yellow”

  • Betroffene Produkte aktiv und im Verkaufskanal sichtbar

  • Suchfelder aktiviert und gewichtet (Name, SKU, Hersteller)

  • Keine Plugin-Konflikte (Third-Party-Plugins einzeln testen)

  • Minimale Suchlänge auf 2-3 Zeichen

  • Cronjob für tägliche Index-Neuaufbau eingerichtet

Wenn diese acht Punkte stimmen und die Suche trotzdem nicht zufriedenstellend funktioniert, ist es Zeit für eine Lösung, die über Keyword-Matching hinausgeht.

Zu Ihrer kostenlosen Demo und sehen Sie, wie sich eine KI-gestützte Suche in Ihrem Shopware-Shop anfühlt.

Datenschutzinformation
Der datenschutzrechtliche Verantwortliche (BatteryIncluded GmbH, Deutschland) würde gerne mit folgenden Diensten Ihre personenbezogenen Daten verarbeiten. Zur Personalisierung können Technologien wie Cookies, LocalStorage usw. verwendet werden. Dies ist für die Nutzung der Website nicht notwendig, ermöglicht aber eine noch engere Interaktion mit Ihnen. Falls gewünscht, können Sie Ihre Einwilligung jederzeit via unserer Datenschutzerklärung anpassen oder widerrufen.