Skip to main content
Wenn Upcart sich nicht öffnet, wenn Kundinnen und Kunden Artikel in den Warenkorb legen, sich öffnet und dann zur Warenkorbseite weiterleitet, ein doppelter Warenkorb erscheint oder gar keiner angezeigt wird, hilft dir diese Anleitung, das Problem zu identifizieren und zu beheben.

​
Welches Problem hast du?

Starte hier, um direkt zur passenden Lösung zu springen: Nicht sicher, was zutrifft? Beginne mit Schritt 1, um zu bestätigen, dass Upcart vollständig aktiviert ist, bevor du dich einem konkreten Problem widmest. Die meisten Probleme mit dem Cart Drawer von Upcart werden verursacht durch:
  • Upcart ist nicht vollständig aktiviert
  • Theme-Warenkorbeinstellungen stehen in Konflikt mit Upcart
  • Die Konfiguration von Enhanced AJAX API Compatibility
  • Drittanbieter-Apps, die das Warenkorbverhalten überschreiben
  • Theme-Cart-Drawer, die mit Upcart in Konflikt stehen
Arbeite die folgenden Schritte der Reihe nach ab und teste nach jeder Änderung.

​
Schritt 1: Stelle sicher, dass Upcart vollständig aktiv ist

Bevor du irgendetwas anderes untersuchst, bestätige, dass Upcart richtig aktiviert ist.

​
1. Stelle sicher, dass der Warenkorb aktiviert ist

Wenn der Warenkorb im Upcart-Editor deaktiviert ist, erscheint er nicht in deinem Storefront.
  • Öffne Upcart
  • Gehe zu Manage all carts
  • Bestätige, dass der Warenkorb veröffentlicht ist

​
2. Aktiviere das App Embed

Wenn das App Embed deaktiviert ist, lädt Upcart nicht.
  • Gehe zu Shopify Admin > Online Store > Themes > Customize
  • Öffne App Embeds
  • Schalte Upcart auf ON
  • Speichere
Teste deinen Warenkorb nach dem Aktivieren dieser Einstellungen. Aktivieren des Upcart-Warenkorbs und Einschalten des App Embeds im Shopify-Adminbereich

​
Problem 1 & 2: Upcart leitet zur Warenkorbseite weiter

Wenn Upcart sich kurz öffnet und dann weiterleitet oder Kundinnen und Kunden direkt zur Warenkorbseite geleitet werden, liegt das meist an einem der folgenden Punkte. Arbeite jeden Schritt durch und teste nach jeder Änderung.

​
1. Prüfe die Checkout-Button-Einstellung in Upcart

Wenn Kundinnen und Kunden auf Checkout klicken und zur Warenkorbseite zurückgeschickt werden:
  1. Gehe zu Upcart > Cart Editor > Settings > Cart settings
  2. Suche „Go to cart page when pressing checkout button“
  3. Schalte diese Option AUS
  4. Speichere und teste
Wenn aktiviert, zwingt diese Option den Checkout-Button, zur Warenkorbseite weiterzuleiten, statt zum Checkout zu gehen. Upcart-Warenkorbeinstellungen mit hervorgehobener Option Go to cart page when pressing checkout

​
2. Prüfe Enhanced AJAX API Compatibility

Gehe zu Upcart > Cart Editor > Settings > Cart settings, klappe Advanced Settings auf und suche Enhanced AJAX API Compatibility. Diese Einstellung ändert, wie Upcart Add-to-Cart-Ereignisse behandelt:
  • Deaktiviert (für die meisten Shops empfohlen) — Upcart fängt Add-to-Cart-Aufrufe ab und verhindert Weiterleitungen
  • Aktiviert — Upcart fängt Add-to-Cart-Aufrufe nicht mehr ab, sodass andere Apps das Warenkorbverhalten steuern können, einschließlich Weiterleitungen
Diese Einstellung ist standardmäßig deaktiviert. Aktiviere sie NUR, wenn dein Shop eine nicht standardmäßige AJAX-Cart-API verwendet und Upcart Add-to-Cart-Ereignisse nicht abfängt. Wenn das Aktivieren dieser Einstellung Weiterleitungen verursacht, deaktiviere sie und verwende stattdessen die manuelle Upcart-API (upcartRegisterAddToCart). Eine vollständige Anleitung findest du unter Enhanced AJAX API Compatibility. Die Einstellung Enhanced Ajax API compatibility und ihre Beschreibung in Upcart

​
3. Ändere den Theme-Warenkorbtyp auf „Page“

Der Cart Drawer oder das Popup deines Themes überschreibt möglicherweise Upcart.
  1. Gehe zu Shopify Admin > Online Store > Themes
  2. Klicke auf Customize
  3. Öffne Theme Settings > Cart
  4. Ändere Cart Type auf Page
  5. Speichere und teste
Das Umstellen des Warenkorbs auf „Page“ verhindert, dass sich der native Drawer des Themes anstelle von Upcart öffnet. Einstellen des Theme-Warenkorbtyps auf Page in den Shopify-Theme-Einstellungen
Wenn dein Theme keine „Cart Type“-Einstellung (oder Ähnliches) enthält, kontaktiere deinen Theme-Entwickler, um die richtige Option zu finden oder hinzuzufügen. Upcart kann Theme-Einstellungen nicht direkt ändern.

​
4. Deaktiviere Theme-Einstellungen für Warenkorb-Weiterleitungen

Manche Themes leiten Kundinnen und Kunden nach dem Hinzufügen eines Produkts automatisch zur Warenkorbseite weiter und umgehen Upcart damit komplett.
  1. Gehe zu Shopify Admin > Online Store > Themes > Customize
  2. Öffne Theme Settings > Products (oder Cart)
  3. Suche nach Einstellungen wie:
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. Schalte diese AUS, speichere und teste

​
5. Prüfe auf Konflikte mit anderen Apps

Viele Drittanbieter-Apps überschreiben das Warenkorbverhalten. Öffne die Einstellungen aller warenkorbbezogenen Apps und suche nach Optionen wie:
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
Ändere diese auf Stay on page oder Do nothing und teste nach jeder Anpassung. Häufige app-spezifische Lösungen:
  • Globo Product Options — Deaktiviere „Redirect to the shopping cart page after adding a product“
  • Zepto Product Personalizer — Gehe zu Zepto > Settings > Add to Cart Settings und ändere „Action after a product is added to the cart“ auf „Stay on the product page and show a success message“
  • PageFly — Deaktiviere alle Warenkorb-Weiterleitungen oder Weiterleitungsregeln in den PageFly-Einstellungen
  • Replo — Passe die „go to page“-Einstellungen an, damit sich der Cart Drawer öffnen kann
Wenn du nicht sicher bist, welche App den Konflikt verursacht, deaktiviere warenkorbbezogene Apps nacheinander und teste nach jeder, bis Upcart funktioniert.

​
Problem 4: Upcart öffnet sich überhaupt nicht

Wenn nichts passiert, wenn Kundinnen und Kunden etwas in den Warenkorb legen oder auf das Warenkorb-Symbol klicken, liegt das meist an einem Theme-Konflikt oder daran, dass Upcart die richtigen Buttons nicht erkennt.

​
Deaktiviere den nativen Cart Drawer des Themes

  1. Gehe zu Shopify Admin > Online Store > Themes > Customize
  2. Öffne Theme Settings > Cart
  3. Stelle den Warenkorbtyp auf Page
  4. Speichere
Stelle sicher, dass die Modi Drawer oder Popup deaktiviert sind.

​
Upcart erkennt deine Buttons nicht?

Manche Themes verwenden benutzerdefinierten Code, der verhindert, dass Upcart den Add-to-Cart-Button oder das Warenkorb-Symbol automatisch erkennt. In diesem Fall kannst du die Button-Selektoren manuell angeben. Schritt 1: Finde den Klassennamen
  1. Öffne deinen Shop in Google Chrome
  2. Klicke mit der rechten Maustaste auf den Add-to-Cart-Button oder das Warenkorb-Symbol
  3. Klicke auf Untersuchen
  4. Suche im hervorgehobenen Code nach etwas wie:
oder
Kopiere nur einen Klassennamen (zum Beispiel: icon-cart). Kopiere nicht class= oder die Anführungszeichen. Untersuchen des Warenkorb-Symbols in den Chrome DevTools, um seinen Klassennamen zu finden Schritt 2: Trage ihn in Upcart ein Du musst einen Punkt (.) vor den Klassennamen setzen, wenn du ihn in Upcart einträgst. Zum Beispiel: .icon-cart
  1. Öffne Upcart
  2. Gehe zu Cart Editor > Settings > Cart settings und klappe dann Advanced Settings auf
  3. Suche die benötigte Selektor-Gruppe:
    • Open cart button selector — für das Warenkorb-Symbol
    • Add to cart button selector — für den Add-to-Cart-Button
  4. Wähle im Options-Dropdown dieser Gruppe Add additional selector (behält Upcarts eigene Erkennung und fügt deine hinzu) oder Use custom selector (nur deine). Das Feld Custom selector bleibt deaktiviert, solange Use default selector ausgewählt ist.
  5. Füge .icon-cart in Custom selector ein und speichere
Eingabe eines benutzerdefinierten Open-cart-button-Selektors in den erweiterten Upcart-Einstellungen

​
Weitere Fehlerbehebung

Wenn das Problem nach den obigen Schritten weiterhin besteht, probiere die folgenden Punkte nacheinander aus und teste nach jeder Änderung.

​
Shadow DOM umschalten (EIN/AUS)

Bei manchen Themes beeinflusst die Shadow-DOM-Einstellung, wie Upcart Buttons und Warenkorb-Ereignisse erkennt.
  1. Gehe zu Upcart > Cart Editor > Settings > Cart settings und klappe dann Advanced Settings auf
  2. Suche Render cart in shadow DOM
  3. Schalte auf EIN, speichere und teste
  4. Schalte auf AUS, speichere und teste erneut
Verwende die Einstellung, die konsistentes Verhalten liefert.

​
AJAX-Einstellung umschalten (EIN/AUS)

Manche Shops verhalten sich je nach Theme- und App-Setup besser, wenn die AJAX-Behandlung umgeschaltet wird.
  1. Gehe zu Upcart > Cart Editor > Settings > Cart settings und klappe dann Advanced Settings auf
  2. Suche Enhanced Ajax API compatibility
  3. Schalte auf EIN, speichere und teste
  4. Schalte auf AUS, speichere und teste erneut
Beachte, dass diese Einstellung auch Upcarts eigene Add-to-Cart-Behandlung deaktiviert. Wenn das Einschalten also die Weiterleitung behebt, solltest du prüfen, ob sich Add to Cart weiterhin wie erwartet verhält. Siehe Enhanced Ajax API compatibility.

​
Browser-Cache leeren

Alte zwischengespeicherte Skripte können das vorherige Warenkorbverhalten beibehalten und verhindern, dass Upcart korrekt lädt.
  1. Öffne die Browser-Einstellungen
  2. Gehe zu Datenschutz & Sicherheit
  3. Wähle Browserdaten löschen
  4. Lösche zwischengespeicherte Bilder, Dateien und Cookies
  5. Aktualisiere die Seite und teste

​
Mit einem Standard-Shopify-Theme testen

  1. Gehe zu Shopify Admin > Online Store > Themes
  2. Füge ein kostenloses Theme wie Dawn hinzu
  3. Aktiviere es vorübergehend
  4. Teste Upcart
Wenn Upcart mit Dawn funktioniert, liegt das Problem an deinem benutzerdefinierten Theme. Kontaktiere deinen Theme-Entwickler für Unterstützung.

​
Apps nacheinander deaktivieren

  1. Gehe zu Shopify Admin > Apps
  2. Deaktiviere jeweils eine warenkorbbezogene App
  3. Teste nach jeder
Wenn Upcart zu funktionieren beginnt, hast du die App gefunden, die den Konflikt verursacht.

​
Browser-Konsole auf Fehler prüfen

  1. Öffne deinen Shop
  2. Drücke F12 (oder Rechtsklick > Untersuchen)
  3. Öffne den Tab Console
  4. Lege ein Produkt in den Warenkorb
  5. Suche nach Fehlern, besonders allem, was mit add.js oder Warenkorb-Ereignissen zusammenhängt
  6. Mache Screenshots von Fehlern, um sie mit dem Support zu teilen

​
Wann du den Support kontaktieren solltest

Wenn du alle Schritte abgeschlossen hast und Upcart immer noch nicht funktioniert, wende dich mit Folgendem an den Support:
  • Theme-Name und -Version
  • Liste der installierten warenkorbbezogenen Apps
  • Screenshots von Konsolenfehlern
  • Schritte, die du bereits ausprobiert hast
Du erreichst den Upcart-Support über den In-App-Chat oder per E-Mail an support@upcart.app.