> ## 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.
# Warum wird mein Checkout-Upsell nicht angezeigt?
> Eine vollständige Aufschlüsselung aller Gründe, warum dein Checkout-Upsell möglicherweise nicht angezeigt wird, einschließlich Problemen mit Einrichtung, Platzierung, Triggern und Produkten/Angeboten.
Checkout-Upsells können aus verschiedenen Gründen nicht angezeigt werden. Arbeite die folgenden Schritte der Reihe nach durch, um die Ursache zu identifizieren.
Checkout-Upsells sind nur für Shopify-Plus-Händler verfügbar, da die Checkout-Extensibility-API von Shopify Plus vorbehalten ist. Wenn du kein Shopify Plus hast, werden Checkout-Upsells unabhängig von deiner Konfiguration nicht angezeigt. Siehe [Warum sehe ich den Checkout-Tab nicht?](/de/aftersell/why_cant_i_see_the_checkout_tab)
Wenn ein Upsell nicht angezeigt wird, bleibt das Checkout-Erlebnis des Kunden unbeeinträchtigt — auf Kundenseite geht nichts kaputt.
***
## Wo du anfangen solltest
Die meisten Anzeigeprobleme lassen sich auf eine von vier Ursachen zurückführen: Das Widget ist nicht aktiviert, der App-Block ist in Shopify nicht hinzugefügt/gespeichert, die Platzierung stimmt nicht überein oder die Trigger-Bedingungen sind nicht erfüllt. Überprüfe zuerst die Grundlagen:
* Du bist auf einem **Shopify-Plus**-Plan
* Das Widget ist im Aftersell-Checkout-Editor **aktiviert** (der **Enable**-Toggle oben rechts in den Widget-Einstellungen ist eingeschaltet)
* Der App-Block wurde im Shopify-Checkout-Editor **hinzugefügt und gespeichert**
* Die in Shopify ausgewählte Platzierung **stimmt mit** der in Aftersell festgelegten Platzierung überein
Wenn all das passt und das Upsell trotzdem nicht angezeigt wird, arbeite die detaillierten Ursachen unten durch.
* [Widget ist nicht aktiviert oder nicht zum Checkout hinzugefügt](#widget-is-not-enabled-or-not-added-to-checkout)
* [Platzierungskonflikt zwischen Aftersell und Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Trigger-Bedingungen werden nicht erfüllt](#trigger-conditions-are-not-being-met)
* [Es liegt ein Produkt- oder Angebotsproblem vor](#there-is-a-product-or-offer-issue)
* [Shop-Pay-Widgets werden nicht angezeigt](#shop-pay-widgets-not-showing)
* [Testen in der Shopify-Vorschau](#testing-in-the-shopify-preview)
* [Nichts davon trifft zu](#nothing-above-applies)
***
## Widget ist nicht aktiviert oder nicht zum Checkout hinzugefügt
Damit ein Checkout-Upsell angezeigt wird, müssen zwei Dinge gleichzeitig zutreffen:
1. Das Widget muss im Aftersell-Checkout-Editor **aktiviert** sein
2. Der App-Block muss im Shopify-Checkout-Editor **hinzugefügt und gespeichert** sein
Fehlt eines davon, erscheint das Widget nicht.
**So aktivierst du das Widget in Aftersell:**
1. Gehe zu **Apps → Aftersell → Checkout**
2. Öffne das Upsell-Widget, das du anzeigen möchtest
3. Bestätige, dass das Widget eingeschaltet ist — die Kopfzeile zeigt einen Toggle neben einem **Active**/**Inactive**-Badge. (Im früheren Checkout-Editor ist dies ein Button-Paar **Enable**/**Disable** in der Kopfzeile der Widget-Karte.)
**So fügst du den App-Block in Shopify hinzu:**
1. Gehe in deinem Shopify-Admin zu **Settings → Checkout**
2. Klicke neben deinem Checkout-Profil auf **Customize**
3. Klicke auf **Add app block** und wähle das Aftersell-Upsell-Widget
4. Positioniere es dort, wo es erscheinen soll
5. Klicke auf **Save** — Änderungen werden erst nach dem Speichern übernommen
***
## Platzierungskonflikt zwischen Aftersell und Shopify
Ein Platzierungskonflikt ist einer der häufigsten Gründe, warum ein Checkout-Upsell nicht angezeigt wird.
Aftersell unterstützt mehrere Platzierungen, damit du mehr als ein Widget desselben Typs auf derselben Checkout-Seite betreiben kannst. Jede Platzierung entspricht einem **eigenen App-Block** im Shopify-Checkout-Editor, und die in Shopify ausgewählte Platzierung muss mit der in Aftersell konfigurierten übereinstimmen.
Das **Placement**-Dropdown des Upsell-Widget-App-Blocks bietet acht Werte: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)** sowie fünf Page-Widget-Slots **page-upsell-001** bis **page-upsell-005**.
Wenn die Platzierungen nicht übereinstimmen, erscheint das Widget nicht oder wird möglicherweise an der falschen Stelle angezeigt.
**So behebst du einen Platzierungskonflikt:**
1. Öffne im Aftersell-Checkout-Editor das Upsell-Widget und notiere, welche Platzierung ausgewählt ist (zum Beispiel **Additional placement 1**)
2. Entferne im Shopify-Checkout-Editor den vorhandenen App-Block für dieses Widget
3. Klicke auf **Add app block**, wähle das Aftersell-Upsell-Widget und wähle **dieselbe Platzierung**, wie sie in Aftersell konfiguriert ist
4. Speichere deine Änderungen
[Mehr über übereinstimmende Platzierungen erfahren →](/de/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)
***
## Trigger-Bedingungen werden nicht erfüllt
Wenn für dein Upsell-Widget Trigger konfiguriert sind, wird es nur angezeigt, wenn der Warenkorb diese Bedingungen erfüllt. Erfüllt der Warenkorb die Trigger-Bedingungen nicht, erscheint das Widget nicht — das ist erwartetes Verhalten.
Zu den verfügbaren Trigger-Typen gehören:
* **Bestimmte Produkte/Kollektionen:** ein ausgewähltes Produkt, eine Variante oder Kollektion ist (oder ist nicht) im Warenkorb
* **Menge eines bestimmten Produkts:** z. B. 2 oder mehr Einheiten eines Produkts
* **Produkt-Tag/Produkttyp/Variantenname:** ein Warenkorbartikel entspricht einem Shopify-Tag, Produkttyp oder Variantentitel (Groß-/Kleinschreibung wird ignoriert)
* **Produkt-Metafeld/Varianten-Metafeld:** ein Produkt oder eine Variante im Warenkorb hat einen passenden Metafeldwert
* **Warenkorb-Zwischensumme:** die Zwischensumme erreicht einen Schwellenwert (siehe Hinweis unten zur Berechnung der Zwischensumme)
* **Warenkorb-Menge:** Gesamtanzahl der Artikel im Warenkorb
* **Abonnement im Warenkorb:** ob ein Warenkorbartikel ein Abonnement ist
* **Warenkorb-Attribut:** ein Attribut-Schlüssel/Wert auf Warenkorbebene stimmt überein (nützlich für Daten, die von anderen Apps gesetzt werden)
* **Angewendeter Rabatt/Rabattwert:** ein bestimmter Rabattcode ist angewendet oder der Gesamtrabatt erreicht einen Schwellenwert
* **Versandland:** das Versandland (und optional die Provinz) des Kunden stimmt überein
* **Kundensprache:** die Sprache des Checkouts stimmt überein (zeige zum Beispiel französische Inhalte nur bei französischen Checkouts)
* **Kunden-Tags:** der angemeldete Kunde hat die erforderlichen Tags
* **Gerätetyp:** der Kunde verwendet das konfigurierte Gerät (Desktop oder Mobil)
Die für die Trigger-Auswertung verwendete **Warenkorb-Zwischensumme** schließt alle Positionen aus, die bereits durch akzeptierte Upsells hinzugefügt wurden (jene, die mit dem Warenkorb-Attribut `__as_offer_id` markiert sind). Das Akzeptieren eines Upsells kann die Zwischensumme also nicht von allein über einen Schwellenwert heben, der ein anderes Widget steuert.
**Bedingungen kombinieren:** Wenn ein Widget mehrere Bedingungen hat, werden sie mit **AND** oder **OR** (nach deiner Wahl) verknüpft, und Bedingungen können für komplexere Logik in Gruppen verschachtelt werden. Bei einer **AND**-Verknüpfung muss jede Bedingung erfüllt sein — eine einzige nicht erfüllte Bedingung blockiert das Widget unbemerkt. Bei einer **OR**-Verknüpfung genügt eine einzige Übereinstimmung. Überprüfe jede Bedingung einzeln anhand deines Testwarenkorbs.
**So behebst du Trigger-Probleme:**
1. Öffne das Widget im Aftersell-Checkout-Editor und überprüfe seine Trigger-Bedingungen
2. Setze den Trigger vorübergehend auf **Show for all customers**, um zu bestätigen, dass das Widget selbst funktioniert, und aktiviere anschließend deine spezifischen Trigger wieder
3. Stelle sicher, dass mindestens ein Widget mit der niedrigsten Priorität einen **Show for all customers**-Trigger als Auffangnetz verwendet, damit immer ein Angebot angezeigt wird, auch wenn kein gezieltes Widget passt
[Mehr über Checkout-Trigger erfahren →](/de/aftersell/checkout_triggers)
***
## Es liegt ein Produkt- oder Angebotsproblem vor
Selbst wenn das Widget aktiviert, korrekt platziert ist und seine Trigger passen, kann das Angebot selbst vor der Anzeige herausgefiltert werden.
Wenn das Inventar des Produkts erfasst wird und keine Variante zum Verkauf verfügbar ist, wird das Angebot nicht angezeigt. Stelle sicher, dass mindestens eine Variante des Upsell-Produkts verfügbares Inventar hat, oder verwende ein Produkt, dessen Inventar nicht erfasst wird.
Das Upsell-Produkt muss ein aktives, verkaufbares Produkt sein. Produkte mit dem Status **Draft** oder **Archived** in Shopify werden herausgefiltert und erscheinen nicht als Angebote. Öffne das Produkt im Shopify-Admin und bestätige, dass sein Status **Active** ist.
Die Einstellung **Hide offer if product already in cart** blendet das Angebot aus, wenn sich das Produkt bereits im Warenkorb des Kunden befindet. Sie ist bei Standard-Produktangeboten standardmäßig aktiviert. Wenn das Upsell trotzdem angezeigt werden soll, deaktiviere diese Einstellung in der Angebotskonfiguration.
Wenn **Subscription purchase option** auf **Subscription** gesetzt ist, das Produkt aber keine in Shopify konfigurierten Verkaufspläne hat, wird das Angebot herausgefiltert. Bestätige, dass das Produkt mindestens einen aktiven Verkaufsplan hat, oder ändere **Subscription purchase option** zu **One-time product** (die anderen Optionen sind **Subscription** und **Subscription and a one-time product**).
Wenn das Angebot als Replacement-Upsell konfiguriert ist, wird es nur angezeigt, wenn das zu ersetzende Produkt im Warenkorb vorhanden ist. Bestätige, dass in der Replacement-Upsell-Konfiguration das richtige Zielprodukt ausgewählt ist.
Ein Replacement-Angebot wird außerdem übersprungen, wenn auf die Zielposition **bereits ein Rabatt angewendet wurde** — es sei denn, du aktivierst **Allow replacement if product has discount applied** — oder wenn die **Menge der Zielposition über eins liegt**, es sei denn, du aktivierst **Allow replacement if product quantity greater than 1**.
Wenn **Max number of accepted offers** für das Widget festgelegt ist, wird das Upsell nicht mehr angezeigt, sobald der Kunde im aktuellen Checkout so viele Angebote aus dem Widget akzeptiert hat. Das ist beabsichtigt — sobald das Limit erreicht ist, blendet sich das Widget selbst aus. Das Feld gilt nur für Single-Product- und Multi-Product-Upsells; Checkmark-Upsells haben kein solches Limit.
Bei **Single**- und **Multi-Product**-Upsells wird das Angebot ausgeblendet, sobald der Kunde das Angebotsprodukt zu seinem Warenkorb hinzufügt (das Produkt befindet sich bereits im Warenkorb). **Checkmark**-Upsells verhalten sich anders — sie bleiben nach dem Akzeptieren mit angekreuztem Kontrollkästchen sichtbar.
***
## Shop-Pay-Widgets werden nicht angezeigt
Checkout-Widgets werden in Shop Pay standardmäßig nicht angezeigt. Um dein Upsell in Shop Pay anzuzeigen, musst du es ausdrücklich aktivieren:
1. Öffne den Aftersell-Upsell-App-Block im Shopify-Checkout-Editor
2. Suche in den Block-Einstellungen den Abschnitt **Checkout behaviour**
3. Aktiviere die Option **Include app block in Shop Pay**
4. Speichere deine Änderungen
[Mehr über Shop-Pay-Widgets erfahren →](/de/aftersell/show_checkout_widgets_in_shop_pay)
***
## Testen in der Shopify-Vorschau
Die Vorschau des Shopify-Checkout-Editors rendert Widgets nicht zuverlässig. Ein Widget kann korrekt konfiguriert sein und trotzdem nicht in der Editor-Vorschau erscheinen, weil die Vorschau Seiten-Tagging und Trigger-Bedingungen nicht simulieren kann. Verlasse dich nicht auf die Editor-Vorschau, um zu bestätigen, ob ein Widget funktioniert.
**So testest du dein Upsell zuverlässig:**
1. Setze den Widget-Trigger vorübergehend auf **Show for all customers**
2. Gib eine echte Testbestellung über das Test-Zahlungsgateway von Shopify auf (oder mit einem Rabattcode, der die Bestellung kostenlos macht)
3. Bestätige, dass das Widget im tatsächlichen Checkout-Ablauf erscheint
4. Setze deine Trigger nach dem Testen zurück
***
## Nichts davon trifft zu
Wenn du alles oben Genannte durchgearbeitet hast und das Upsell immer noch nicht angezeigt wird, bestätige Folgendes:
* Das Widget ist in Aftersell **aktiviert** und der App-Block ist im Shopify-Checkout-Editor **hinzugefügt und gespeichert**
* Die **Platzierung** in Aftersell stimmt mit der in Shopify ausgewählten Platzierung überein
* Die Trigger-Bedingungen passen zu deinem Testwarenkorb — denke daran, dass bei einer **AND**-Verknüpfung jede Bedingung erfüllt sein muss
* Es gibt mindestens ein Widget mit einem **Show for all customers**-Trigger mit der niedrigsten Priorität als Auffangnetz
* Das Upsell-Produkt ist **Active**, vorrätig und hat (bei Abonnement-Angeboten) aktive Verkaufspläne
* Du testest mit einem **echten Checkout-Ablauf**, nicht mit der Shopify-Editor-Vorschau
* Versuche, deinen Browser-Cache zu leeren oder in einem Inkognito-Fenster zu testen — Änderungen können einige Minuten dauern, bis sie wirksam werden
Immer noch nicht gelöst? Melde dich per Chat oder schreibe uns eine E-Mail an [support@aftersell.app](mailto:support@aftersell.app) und füge eine Beschreibung deiner Widget-Einrichtung und die Details der Testbestellung bei.