> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Fehlerbehebung: Upcart öffnet sich nicht oder leitet zur Warenkorbseite weiter
> Leitfaden zur Fehlerbehebung bei Cart-Drawer-Problemen in Upcart, etwa wenn der Drawer sich nicht öffnet, zur Warenkorbseite weiterleitet, zwei Warenkörbe gleichzeitig erscheinen, der Warenkorb nicht lädt oder Upcart beim Hinzufügen von Artikeln zum Warenkorb nicht reagiert.
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:
* [**Upcart öffnet sich kurz und leitet dann zur Warenkorbseite weiter**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Kundinnen und Kunden werden direkt zur Warenkorbseite geleitet, statt Upcart zu sehen**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Zwei Warenkörbe erscheinen gleichzeitig (Upcart und der Theme-Warenkorb)**](#3-change-theme-cart-type-to-page)
* [**Upcart öffnet sich überhaupt nicht**](#issue-4-upcart-is-not-opening-at-all)
Nicht sicher, was zutrifft? Beginne mit [Schritt 1](#step-1-make-sure-upcart-is-fully-active), 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.
***
## 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.
### 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](/de/upcart/enhanced_ajax_api_compatibility).
### 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.
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:
```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```
oder
```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```
Kopiere nur **einen Klassennamen** (zum Beispiel: `icon-cart`). Kopiere nicht `class=` oder die Anführungszeichen.
**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
***
## 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](/de/upcart/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](mailto:support@upcart.app).