Fehlermeldungen und was sie bedeuten
Jede Meldung der App ist hier mit Ursache und Lösung aufgeführt — gesucht nach dem Text, der bei dir auf dem Bildschirm steht.
Die Mitteilung erscheint nicht im Shop
„Die Mitteilung ist im Shop noch nicht sichtbar“
Der App-Block ist im veröffentlichten Theme nicht aktiv. Solange er fehlt, sieht niemand die gesetzliche Gewährleistungsmitteilung. Häufigste Ursache: Der Block wurde in einem Entwurfs-Theme eingebaut oder im Theme-Editor nicht gespeichert. Gehe über die Karte Einrichtung zurück in den Theme-Editor, prüfe, dass du im veröffentlichten Theme bist, und speichere.
„Für diese Sprache liegt keine Sprachfassung vor“
Es würde nichts erscheinen — die App zeigt bewusst keine fremdsprachige Ersatzfassung. Sobald der Shop diese Sprache führt, wird die amtliche Datei automatisch hinterlegt. Prüfe unter Shopify → Einstellungen → Sprachen, ob die Sprache dort veröffentlicht ist.
„Noch kein Snippet verfügbar“
Für diese Sprachfassung liegt noch keine öffentliche Bilddatei vor. Eine Benachrichtigungsvorlage kann die Datei der Theme-Erweiterung nicht referenzieren, und eine nachgebaute Textfassung ist als Ersatz für die amtliche Grafik nicht zulässig. Warte einen Moment und lade neu — die App legt die Dateien im Hintergrund in deinen Shopify-Dateien ab.
Mein Theme nimmt den Produktseiten-Block nicht
Dann hat dein veröffentlichtes Theme keine Produktvorlage, die App-Blöcke aufnimmt — das betrifft ältere Themes vor Online Store 2.0. Der App-Embed aus Schritt 2 der Einrichtung funktioniert unabhängig davon und deckt die Pflicht ab.
Speichern und Produktpflege
„Speichern nicht möglich“
Zwei Ursachen, und die Meldung nennt dir die richtige:
- Das Produktlimit ist erreicht — die Meldung nennt die Zahlen („… von …“). Bereits gepflegte Produkte lassen sich weiter bearbeiten; nur neue kommen nicht dazu. Entweder ein anderes Produkt abschalten oder den Tarif wechseln.
- Herstellergarantien sind in diesem Plan nicht enthalten — der Gratis-Plan pflegt keine GARAN-Angaben. Die gesetzliche Gewährleistungsmitteilung läuft davon unberührt weiter.
„Herstellergarantien sind nicht freigeschaltet“
Ein Hinweis, keine Störung: Alle physischen Produkte zeigen die gesetzliche Gewährleistungsmitteilung — dafür ist kein bezahlter Plan nötig. Nur die GARAN-Herstellergarantie braucht Kontingent.
„Speichern fehlgeschlagen“
Der Schreibvorgang nach Shopify ist nicht durchgelaufen. Deine Eingaben stehen noch im Formular — versuche es direkt erneut. Bleibt es dabei, ist meist Shopify kurzzeitig nicht erreichbar.
Die Garantiedauer wird nicht angenommen
Erlaubt sind ganze und halbe Jahre mit Komma, und es müssen mehr als zwei sein: 2 ist unzulässig, 2,5 ist zulässig. Monatsangaben werden nicht umgerechnet.
Ein langer Markenname bekommt keine Druckdatei
Marke und Modellkennung müssen in die amtliche Grafik passen, ohne dass Typografie oder Abstände verändert werden. Das Formular zeigt dir beim Tippen, bis wohin ein Wert passt. Ist er zu lang, lässt er sich speichern, aber nicht drucken — kürze ihn für die Druckdatei.
CSV-Import
„Die Spaltenüberschriften wurden nicht erkannt“
Die Datei hat andere Spalten als erwartet. Am sichersten ist die Datei aus dem Export dieser App: exportieren, die GARAN-Spalten ergänzen, unverändert zurückspielen. Semikolon-, Komma- und Tabulator-Trennung werden erkannt.
„Produkt mit dem Handle … nicht gefunden“
Der Handle steht nicht in deinem Katalog — meist ein Tippfehler oder ein Produkt, das es nicht mehr gibt. Die gültigen Handles stehen in der Exportdatei.
„Bitte ja/nein (true/false) angeben — prüfe, ob eine Spalte verschoben ist“
Das ist fast immer eine verschobene Spalte, und die Ursache ist fast immer das Feld terms: Es enthält die Anschrift des Garantiegebers und damit Kommas. Ohne Anführungszeichen rutschen alle folgenden Spalten eine Position weiter.
„Diese variant_id gehört nicht zu diesem Produkt“
Zeile und Spalten prüfen — Produkt und Variante passen nicht zusammen. Beide Kennungen stehen in der Exportdatei; variant_sku allein genügt nicht.
Nach dem Import fehlen einzelne Zeilen
Das ist beabsichtigt: Jede Zeile wird einzeln geprüft. Fehlerhafte Zeilen werden übersprungen, alle gültigen sind eingetragen. Im Fehlerbericht stehen Zeile, Spalte und Fehler — korrigiere nur die beanstandeten Zeilen und lade die Datei erneut.
Export, Nachweis und Poster
„Es läuft bereits ein Export“
Ein Export dieses Shops ist gerade unterwegs. Sobald er fertig ist, kannst du den nächsten starten — es wurde nichts geändert.
„Export ohne Zeilen“ oder „Nichts zu exportieren“
Der Export ist fertig, enthält aber keine Produkte. Bei „Nur offene Punkte exportieren“ ist das die gute Nachricht: Es gibt keine offenen Punkte.
„Nachweis wurde nicht erstellt“
Es wurde kein Dokument gespeichert — du kannst es direkt erneut versuchen. Der Hinweis bleibt stehen, bis du es tust; er verschwindet nicht von selbst.
Wenn die App gar keine Daten zeigt
„Daten vorübergehend nicht verfügbar“ / „Daten konnten nicht geladen werden“
Die App konnte Shopify nicht erreichen. Sie zeigt dann bewusst einen Fehlerzustand statt einer Null — lade die Seite neu. Hält es an, prüfe die Shopify-Statusseite.
„Die Synchronisierung wurde nicht gestartet“
Der Abgleich mit dem Shopify-Katalog konnte nicht gestartet werden. Die gespeicherten Angaben sind unverändert — du kannst es direkt erneut versuchen.
„Etwas ist schiefgelaufen“ / „Diese Seite hat einen unerwarteten Fehler“
Ein Fehler, den die App nicht einordnen konnte. Lade die Seite neu. Tritt er wieder auf, schreib dem Support mit der Angabe, welche Seite es war und was du zuletzt getan hast.
Nach einer Erweiterung der Berechtigungen
Wenn die App eine neue Berechtigung braucht, fragt Shopify dich im Admin um Zustimmung. Bis du sie erteilt hast, arbeitet die App im bisherigen Umfang weiter, und der Self-Check weist die betroffene Zeile als ungeprüft aus statt sie fälschlich grün zu zeigen.