Checkliste zur Theme-Kompatibilität für Shopify-B2B-Apps: So testen Sie vor der Installation

Testen Sie eine Shopify-B2B-App auf einer Kopie Ihres Themes, bevor sie das Live-Theme berührt. Prüfen Sie, ob das Theme JSON-Templates nutzt, schalten Sie den App-Embed ein, fügen Sie alle App-Blöcke hinzu und gehen Sie dann mit einem Gast, einem Käufer mit Kunden-Tag und einem Kunden ohne Tag jede Seite durch, die die App verändert.

Zuletzt aktualisiert am 4. Oktober 2026. Die Shopify-Fakten stammen von den im Text verlinkten Seiten, gelesen an diesem Datum. Die BSS-Fakten stammen aus den Nutzerhandbüchern unter docs.bss-b2b.solutions und unserer Prüfung der Apps vom Oktober 2026. BSS B2B Solutions entwickelt BSS B2B Solution, Lock und Quote. Diese Checkliste gilt für jede B2B-App. Sie ist Teil unseres kompletten Leitfadens zu Shopify B2B; wenn Sie ein Theme auswählen statt testen wollen, lesen Sie den Leitfaden zu Shopify-B2B-Themes.

Was bedeutet Theme-Kompatibilität für eine B2B-App?

Eine B2B-App verändert Preise, Buttons, Formulare und Seiten auf drei Wegen. Ein App-Embed lädt ein Skript für das ganze Theme. Ein App-Block ist ein Block, den Sie im Theme-Editor einem Template hinzufügen. Manche Apps schreiben Code in Theme-Dateien. Jeder Weg scheitert anders: Ein ausgeschalteter Embed zeigt nichts, ein Block lässt sich nicht in einem alten Template hinzufügen, und geschriebener Code kann bei einem Theme-Update überschrieben werden.

Shopify verlangt für App-Blöcke JSON-Templates (shopify.dev). So prüfen Sie Ihr Theme: Öffnen Sie Online Store, Themes, Edit code und schauen Sie im Ordner templates nach. Dateien mit der Endung .json sind JSON-Templates. Ein Theme, dessen Produkt- und Kollektions-Templates .liquid -Dateien sind, ist ein Legacy-Theme, und dort funktionieren App-Blöcke nicht.

So greift jede BSS-App in Ihr Theme ein

App	Wie sie das Theme erreicht	Anforderungen und Hinweise zum Theme
BSS B2B Solution	Ein App-Embed mit dem Namen B2B Solution lädt die Skripte für den Shop. Einige Module brauchen zusätzlich Preis-Snippets in Produkt-, Kollektions- und Warenkorb-Templates.	Der Embed gilt pro Theme. Online-Store-2.0-Themes funktionieren mit Blöcken und Embeds. Legacy-Themes brauchen unter Umständen ein manuelles Snippet. Die Dokumentation nennt 13 Online-Store-2.0-Themes und 28 Premium-Themes als unterstützt
BSS B2B Lock	Schreibt Liquid-Snippets in Ihr Theme und bearbeitet layout/theme.liquid sowie Produkt-, Preis- und Formulardateien, damit die Regeln greifen, wenn Shopify die Seite rendert. Ein zweiter App-Embed übernimmt Passcode-Pop-ups, Zugriffsanfragen und das Ausblenden der beschleunigten Checkout-Buttons.	Die automatische Installation funktioniert bei kostenlosen Themes. Bei kostenpflichtigen Themes kann eine manuelle Installation nötig sein. Headless-Shops werden nicht unterstützt.
BSS B2B Quote	Quick-Order-Seiten schreiben einen Abschnitt und ein Seiten-Template in das Live-Theme. Die Variantentabelle ist ein App-Block im Produkt-Template. Angebotsbuttons kommen aus dem App-Embed.	Quick Order und die Variantentabelle brauchen ein Produkt- oder Seiten-Template für Online Store 2.0. Quote hat 63 Theme-Voreinstellungen und greift bei Themes, die es nicht kennt, auf die Voreinstellung Dawn oder Horizon zurück.

BSS B2B Solution

Alles lädt über einen einzigen Embed im Kopfbereich. Ist er aus, erscheinen keine Preise, Tabellen, Formulare oder Meldungen, auch wenn Regeln gespeichert sind. Ein neu veröffentlichtes oder dupliziertes Theme übernimmt die Einstellung nicht (Anleitung). Die App prüft außerdem auf Online Store 2.0, indem sie nach JSON-Templates für Produkt, Kollektion, Warenkorb und Startseite sucht. Die Liste unterstützter Themes nennt die Themes, bei denen die Installation automatisch läuft, und sagt, dass ihr Team die Integration für ein nicht gelistetes Theme anpassen kann. Testen Sie diese Punkte: Die App blendet „Jetzt kaufen“ aus, wenn Regeln aktiv sind, und Warenkorb-Drawer sowie Schnellansichten brauchen eventuell manuelle CSS-Selektoren.

BSS B2B Lock

Lock funktioniert nicht nur über den App-Embed. Damit Regeln korrekt greifen, installiert die App Code in Ihr Theme, und die Anleitung empfiehlt, zuerst auf einem Test-Theme zu installieren. Im Reiter Installation wählen Sie Install to TEST (Draft) oder Install to LIVE. Wenn Locks bereits funktionieren, starten Sie die automatische Installation nicht noch einmal, denn sie kann zu Inkompatibilität führen. Lock wird auf kostenlosen Themes wie Dawn, Ride, Horizon und Spotlight getestet und funktioniert auf kostenpflichtigen Themes eventuell nur teilweise (Installationsanleitung).

Da der Code im Theme bleibt, planen Sie auch den Ausstieg. Bevor Sie die App deinstallieren oder das Theme wechseln, öffnen Sie Theme Cleanup und klicken Sie auf Disable all rules. Ein ruhendes Snippet kann zurückbleiben, und der Support entfernt auf Anfrage jede Datei (Anleitung zur Theme-Bereinigung). Unsere Anleitung zur Deinstallation einer B2B- oder Lock-App beschreibt jeden Schritt, um übrig gebliebenen Theme-Code zu entfernen.

BSS B2B Quote

Wenn Sie eine Quick-Order-Seite veröffentlichen, kommen ihre Dateien in das Theme, das in diesem Moment live ist. Ein neues Theme bekommt sie nicht automatisch. Unter Advanced Settings, Theme installation sehen Sie bei jedem Theme den Status (Installed, Needs update oder Not installed) und klicken auf Install. So bereiten Sie ein Duplikat vor, bevor es live geht (Anleitung). Die Seite braucht ein Theme mit Online Store 2.0. Die Variantentabelle ist ein App-Block „BSS Product Page Variant Table“, den Sie dem Produkt-Template hinzufügen. Im Live-Shop zeigt sie sich ab dem Business-Plan. Für Angebotsbuttons bei stark angepassten oder kostenpflichtigen Themes kann eine manuelle Installation oder Hilfe des Supports nötig sein (Quote-FAQ).

Checkliste zur Theme-Kompatibilität

Vor der Installation

• ☐ Notieren Sie Theme-Name und Version sowie ob das Theme kostenlos, kostenpflichtig oder individuell ist.
• ☐ Öffnen Sie Edit code und prüfen Sie, dass Produkt-, Kollektions-, Warenkorb- und Startseiten-Templates als .json-Dateien vorliegen.
• ☐ Prüfen Sie, ob das Theme auf der unterstützten Liste der App steht, und notieren Sie alles, was angepasst wurde: Warenkorb-Drawer, Schnellansicht, eigene Preis-Snippets.
• ☐ Duplizieren Sie das Theme, benennen Sie es klar und lassen Sie das Original unverändert.
• ☐ Legen Sie Testkunden an: einen mit Ihrem Großhandels-Tag und einen ohne. Für einen Gast nutzen Sie ein privates Fenster.

Auf dem Duplikat installieren

• ☐ Installieren Sie die App und öffnen Sie dann den Theme-Editor für das Duplikat und schalten Sie den App-Embed ein.
• ☐ Fügen Sie App-Blöcke dort hinzu, wo die App sie braucht: Variantentabelle im Produkt-Template.
• ☐ Wählen Sie bei Lock Install to TEST (Draft) und das Duplikat. Für Quote nutzen Sie Theme installation und installieren auf dem Duplikat.
• ☐ Zeigen Sie eine Vorschau des Duplikats und prüfen Sie, ob der Editor ohne Fehler lädt.

Jede Oberfläche testen

Oberfläche	Prüfung	Warum sie bei manchen Themes scheitert
Produktseite	Preis, „In den Warenkorb“, „Jetzt kaufen“, Mengenfeld, Staffeltabelle	Eigener Preis-Markup oder Abschnitte, die die App nicht findet
Kollektionsraster und Suche	Preise und Badges auf jeder Karte	Themes mit eigenen Karten-Snippets
Schnellansicht und Warenkorb-Drawer	Preise und Regeln im Pop-up	Dafür können manuelle CSS-Selektoren nötig sein
Warenkorbseite	Hinweis zum Bestelllimit	App-Block fehlt im Warenkorb-Template
Login und Registrierung	Formulare werden angezeigt, der Login-Hinweis verlinkt auf die richtige Seite	Konto-Templates, die das Theme verändert hat
Gesperrte Seiten und Preise	Gast sieht die Sperrmeldung, Käufer mit Tag sieht die Inhalte	Theme-Dateien, die die Installation nicht angepasst hat
Quick Order und Angebotsbutton	Seite lädt, Suche, CSV-Upload, Angebotsformular öffnet sich	Altes Template oder fehlende Dateien in diesem Theme
Mobil	Alle Punkte oben in Smartphone-Breite	Layout und Sticky-Elemente überlappen sich
Theme-Editor	Editor lädt, und Sie können Abschnitte bearbeiten	Lock lässt sich im Editor über dessen Einstellungen deaktivieren

Vor dem Go-live

• ☐ Vergleichen Sie das Duplikat mit dem Original bei demselben Produkt, derselben Kollektion und demselben Warenkorb.
• ☐ Prüfen Sie den Checkout mit einer Testbestellung. Shopify empfiehlt, als Testkunde mit dem Test-Zahlungsanbieter zu testen (Shopify-Hilfe-Center).
• ☐ Veröffentlichen Sie das Duplikat, schalten Sie dann den App-Embed im Live-Theme ein und wiederholen Sie dort die Installationsschritte für Lock und Quote.
• ☐ Behalten Sie das alte Theme für eine Rückfallphase. Wissen Sie, wo Theme Cleanup liegt.
• ☐ Wiederholen Sie nach jedem Theme-Update die Testmatrix.

Wenn Ihr Theme nicht auf der Liste steht

Ein Theme außerhalb der geprüften Liste ist ein Testfall, keine Ablehnung. Führen Sie die Checkliste aus, notieren Sie, welche Oberflächen scheitern, und schicken Sie dem Support den Theme-Namen, eine Produkt-URL und einen Screenshot. Die BSS-Dokumentation sagt, dass das Team die Integration für ein Theme anpassen kann, das nicht voll unterstützt wird. Wenn Sie noch ein Theme auswählen, lesen Sie den Leitfaden zu Shopify-B2B-Themes, für B2B-spezifische Optionen siehe Shopify-B2B-Themes.

Was wir nicht behaupten

• Wir behaupten nicht, dass eine BSS-App mit jedem Theme funktioniert.
• Wir haben Headless- oder Hydrogen-Shops nicht geprüft. Die Apps hängen vom Theme, dessen Embed und Liquid ab. Behandeln Sie Headless daher als nicht unterstützt, sofern der Support nichts anderes bestätigt.
• Ein heutiger Test deckt kein künftiges Theme-Update ab.

Kompatibilität von Shopify-B2B-Apps mit Themes: häufig gestellte Fragen

Nächste Schritte

Wählen Sie die App, die Sie testen möchten, duplizieren Sie Ihr Theme und führen Sie die Checkliste oben aus. Die Checkliste zur Einrichtung nimmt diesen Test in die vollständige Einrichtung in zehn Schritten auf. Passende Use Cases: Großhandelspreise vor Gastbesuchern verbergen und Variantentabelle auf der Produktseite. Der Hub zur Zugriffskontrolle und der Hub zu Quick Order und RFQ behandeln Lock und Quote.

Quellen

Shopify-Seiten, gelesen am 4. Oktober 2026. BSS-Fakten: BSS-Nutzerhandbücher unter docs.bss-b2b.solutions und unsere Prüfung des Verhaltens der Apps vom Oktober 2026.

• Shopify-Hilfe-Center: Themes duplizieren
• shopify.dev: App-Blöcke
• Shopify-Hilfe-Center: Die B2B-Kundenerfahrung testen
• BSS B2B Solution Nutzerhandbuch: Liste unterstützter Themes
• BSS B2B Solution Nutzerhandbuch: App im Theme aktivieren oder deaktivieren
• BSS B2B Lock Nutzerhandbuch: BSS B2B Lock installieren und öffnen
• BSS B2B Lock Nutzerhandbuch: Theme Cleanup
• BSS B2B Quote Nutzerhandbuch: Quick Order auf einem Theme installieren

• Facebook
• Twitter
• LinkedIn
• Pinterest