> ## 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.

# Waarom wordt mijn checkout-upsell niet weergegeven?

> Een volledig overzicht van elke reden waarom je checkout-upsell mogelijk niet wordt getoond, inclusief problemen met setup, plaatsing, triggers en product/aanbieding.

Checkout-upsells kunnen om verschillende redenen niet worden weergegeven. Doorloop de onderstaande stappen op volgorde om de oorzaak te achterhalen.

<Note>
  Checkout-upsells zijn alleen beschikbaar voor Shopify Plus-merchants, omdat de Checkout Extensibility API van Shopify alleen voor Plus is. Zit je niet op Shopify Plus, dan verschijnen checkout-upsells niet, ongeacht je configuratie. Zie [Waarom zie ik het checkout-tabblad niet?](/nl/aftersell/why_cant_i_see_the_checkout_tab)
</Note>

<Tip>
  Als een upsell niet wordt weergegeven, blijft de checkout-ervaring van de klant onaangetast — er gaat niets kapot aan de kant van de klant.
</Tip>

***

<div id="where-to-start">
  ## Waar te beginnen
</div>

De meeste weergaveproblemen komen neer op een van vier dingen: de widget is niet ingeschakeld, het app block is niet toegevoegd/opgeslagen in Shopify, de plaatsing komt niet overeen, of er wordt niet aan de triggervoorwaarden voldaan. Bevestig eerst de basis:

* Je zit op een **Shopify Plus**-plan
* De widget is **ingeschakeld** in de Aftersell Checkout-editor (de **Enable**-schakelaar rechtsboven in de widgetinstellingen staat aan)
* Het app block is **toegevoegd en opgeslagen** in de Shopify Checkout Editor
* De in Shopify geselecteerde plaatsing **komt overeen** met de plaatsing die in Aftersell is ingesteld

Klopt dat allemaal en wordt de upsell nog steeds niet getoond, doorloop dan de gedetailleerde oorzaken hieronder.

* [Widget is niet ingeschakeld of niet toegevoegd aan de checkout](#widget-is-not-enabled-or-not-added-to-checkout)
* [Plaatsingsmismatch tussen Aftersell en Shopify](#placement-mismatch-between-aftersell-and-shopify)
* [Er wordt niet aan de triggervoorwaarden voldaan](#trigger-conditions-are-not-being-met)
* [Er is een product- of aanbiedingsprobleem](#there-is-a-product-or-offer-issue)
* [Shop Pay-widgets worden niet getoond](#shop-pay-widgets-not-showing)
* [Testen in de Shopify-preview](#testing-in-the-shopify-preview)
* [Niets van het bovenstaande is van toepassing](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## Widget is niet ingeschakeld of niet toegevoegd aan de checkout
</div>

Om een checkout-upsell weer te geven, moeten twee dingen tegelijk waar zijn:

1. De widget moet **ingeschakeld** zijn in de Aftersell Checkout-editor
2. Het app block moet **toegevoegd en opgeslagen** zijn in de Shopify Checkout Editor

Ontbreekt een van beide, dan verschijnt de widget niet.

**Zo schakel je de widget in in Aftersell:**

1. Ga naar **Apps → Aftersell → Checkout**
2. Open de upsell-widget die je wilt weergeven
3. Bevestig dat de widget aanstaat — de header toont een schakelaar naast een badge **Active** / **Inactive**. (In de eerdere Checkout-editor is dit een knoppenpaar **Enable** / **Disable** in de header van de widgetkaart.)

**Zo voeg je het app block toe in Shopify:**

1. Ga naar **Settings → Checkout** in je Shopify Admin
2. Klik op **Customize** naast je checkoutprofiel
3. Klik op **Add app block** en selecteer de Aftersell-upsellwidget
4. Positioneer het waar je het wilt laten verschijnen
5. Klik op **Save** — wijzigingen worden pas toegepast na het opslaan

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## Plaatsingsmismatch tussen Aftersell en Shopify
</div>

Een plaatsingsmismatch is een van de meest voorkomende redenen waarom een checkout-upsell niet wordt weergegeven.

Aftersell ondersteunt meerdere plaatsingen, zodat je meer dan één widget van hetzelfde type op dezelfde checkoutpagina kunt draaien. Elke plaatsing komt overeen met een **apart app block** in de Shopify Checkout Editor, en de in Shopify geselecteerde plaatsing moet overeenkomen met de plaatsing die in Aftersell is geconfigureerd.

De dropdown **Placement** van het Upsell Widget-app block biedt acht waarden: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)** en vijf page-widget-slots **page-upsell-001** tot en met **page-upsell-005**.

Komen de plaatsingen niet overeen, dan verschijnt de widget niet of wordt hij mogelijk op de verkeerde plek weergegeven.

**Zo los je een plaatsingsmismatch op:**

1. Open in de Aftersell Checkout-editor de upsell-widget en noteer welke plaatsing is geselecteerd (bijvoorbeeld **Additional placement 1**)
2. Verwijder in de Shopify Checkout Editor het bestaande app block voor deze widget
3. Klik op **Add app block**, selecteer de Aftersell-upsellwidget en kies **dezelfde plaatsing** als in Aftersell is geconfigureerd
4. Sla je wijzigingen op

[Meer informatie over overeenkomende plaatsingen →](/nl/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## Er wordt niet aan de triggervoorwaarden voldaan
</div>

Heeft je upsell-widget triggers geconfigureerd, dan wordt hij alleen weergegeven wanneer de winkelwagen aan die voorwaarden voldoet. Voldoet de winkelwagen niet aan de triggervoorwaarden, dan verschijnt de widget niet — dit is verwacht gedrag.

Beschikbare triggertypes zijn onder andere:

* **Specifieke producten / collecties:** een gekozen product, variant of collectie zit (of zit niet) in de winkelwagen
* **Aantal van een specifiek product:** bijv. 2 of meer van een product
* **Producttag / producttype / variantnaam:** een winkelwagenitem matcht een Shopify-tag, producttype of varianttitel (niet hoofdlettergevoelig)
* **Product-metafield / variant-metafield:** een product of variant in de winkelwagen heeft een matchende metafield-waarde
* **Subtotaal winkelwagen:** het subtotaal haalt een drempel (zie de opmerking hieronder over hoe het subtotaal wordt berekend)
* **Aantal artikelen in winkelwagen:** totaal aantal items in de winkelwagen
* **Abonnement in winkelwagen:** of een winkelwagenitem een abonnement is
* **Cart attribute:** een attribuutsleutel/-waarde op winkelwagenniveau matcht (handig voor data die door andere apps wordt gezet)
* **Toegepaste korting / kortingswaarde:** een specifieke kortingscode is toegepast, of de totale korting haalt een drempel
* **Verzendland:** het verzendland (en optioneel de provincie) van de klant matcht
* **Klanttaal:** de taal van de checkout matcht (bijvoorbeeld: toon Franse content alleen aan Franse checkouts)
* **Klanttags:** de ingelogde klant heeft de vereiste tags
* **Apparaattype:** de klant gebruikt het geconfigureerde apparaat (desktop of mobiel)

<Note>
  Het **subtotaal van de winkelwagen** dat voor triggerevaluatie wordt gebruikt, sluit regelitems uit die al door geaccepteerde upsells zijn toegevoegd (die getagd zijn met het cart attribute `__as_offer_id`). Het accepteren van één upsell duwt het subtotaal dus op zichzelf niet over een drempel die een andere widget afschermt.
</Note>

**Voorwaarden combineren:** heeft een widget meerdere voorwaarden, dan worden ze verbonden met **AND** of **OR** (jouw keuze), en voorwaarden kunnen in groepen worden genest voor complexere logica. Bij een **AND**-verbinding moet aan elke voorwaarde worden voldaan — één niet-gematchte voorwaarde blokkeert de widget stilzwijgend. Bij een **OR**-verbinding is één match voldoende. Controleer elke voorwaarde afzonderlijk aan de hand van je testwinkelwagen.

**Zo troubleshoot je triggers:**

1. Open de widget in de Aftersell Checkout-editor en bekijk de triggervoorwaarden
2. Zet de trigger tijdelijk op **Show for all customers** om te bevestigen dat de widget zelf werkt, en schakel daarna je specifieke triggers weer in
3. Zorg dat minstens één widget een trigger **Show for all customers** op de laagste prioriteit gebruikt als catch-all, zodat er altijd een aanbieding wordt weergegeven, ook als geen gerichte widget matcht

[Meer informatie over checkout-triggers →](/nl/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## Er is een product- of aanbiedingsprobleem
</div>

Zelfs wanneer de widget is ingeschakeld, correct is geplaatst en de triggers matchen, kan de aanbieding zelf worden weggefilterd voordat deze wordt weergegeven.

<AccordionGroup>
  <Accordion title="Het upsell-product is niet op voorraad">
    Als de voorraad van het product wordt bijgehouden en geen enkele variant beschikbaar is voor verkoop, wordt de aanbieding niet weergegeven. Zorg dat minstens één variant van het upsell-product beschikbare voorraad heeft, of gebruik een product waarvan de voorraad niet wordt bijgehouden.
  </Accordion>

  <Accordion title="Het upsell-product heeft de status Draft of Archived">
    Het upsell-product moet een live, verkoopbaar product zijn. Producten met de status **Draft** of **Archived** in Shopify worden weggefilterd en verschijnen niet als aanbiedingen. Open het product in de Shopify Admin en bevestig dat de status **Active** is.
  </Accordion>

  <Accordion title="Het upsell-product zit al in de winkelwagen en 'hide if already in cart' is ingeschakeld">
    De instelling **Hide offer if product already in cart** verbergt de aanbieding wanneer dat product al in de winkelwagen van de klant zit. Deze staat standaard aan voor standaard productaanbiedingen. Wil je dat de upsell sowieso wordt getoond, schakel deze instelling dan uit in de aanbiedingsconfiguratie.
  </Accordion>

  <Accordion title="Het upsell-product is een abonnement maar heeft geen selling plans">
    Als **Subscription purchase option** is ingesteld op **Subscription** maar het product geen selling plans in Shopify heeft geconfigureerd, wordt de aanbieding weggefilterd. Bevestig dat het product minstens één actief selling plan heeft, of wijzig **Subscription purchase option** naar **One-time product** (de andere keuzes zijn **Subscription** en **Subscription and a one-time product**).
  </Accordion>

  <Accordion title="Het doelproduct van de replacement upsell zit niet in de winkelwagen">
    Is de aanbieding geconfigureerd als replacement upsell, dan wordt deze alleen weergegeven wanneer het product dat hij moet vervangen in de winkelwagen zit. Bevestig dat het juiste doelproduct is geselecteerd in de configuratie van de replacement upsell.

    Een replacement-aanbieding wordt ook overgeslagen wanneer op de doelregel **al een korting is toegepast** — tenzij je **Allow replacement if product has discount applied** aanvinkt — of wanneer het **aantal van de doelregel hoger dan één** is, tenzij je **Allow replacement if product quantity greater than 1** aanvinkt.
  </Accordion>

  <Accordion title="Het maximumaantal geaccepteerde aanbiedingen is bereikt">
    Als **Max number of accepted offers** op de widget is ingesteld, stopt de upsell met weergeven zodra de klant dat aantal aanbiedingen van de widget in de huidige checkout heeft geaccepteerd. Dit is opzettelijk — zodra de limiet is bereikt, verbergt de widget zichzelf. Het veld geldt alleen voor Single product- en Multi product-upsells; Checkmark-upsells hebben zo'n limiet niet.
  </Accordion>

  <Accordion title="De aanbieding is al door deze widget aan de winkelwagen toegevoegd">
    Bij **single**- en **multi-product**-upsells wordt de aanbieding verborgen zodra de klant het aanbiedingsproduct aan de winkelwagen toevoegt (het product zit immers al in de winkelwagen). **Checkmark**-upsells gedragen zich anders — die blijven zichtbaar met het selectievakje aangevinkt nadat ze zijn geaccepteerd.
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## Shop Pay-widgets worden niet getoond
</div>

Checkout-widgets worden standaard niet weergegeven in Shop Pay. Om je upsell in Shop Pay te tonen, moet je dit expliciet inschakelen:

1. Open het Aftersell-upsell app block in de Shopify Checkout Editor
2. Zoek in de blokinstellingen de sectie **Checkout behaviour**
3. Vink de optie **Include app block in Shop Pay** aan
4. Sla je wijzigingen op

[Meer informatie over Shop Pay-widgets →](/nl/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## Testen in de Shopify-preview
</div>

De preview van de Shopify Checkout Editor rendert widgets niet betrouwbaar. Een widget kan correct geconfigureerd zijn en toch niet in de editorpreview verschijnen, omdat de preview paginatagging en triggervoorwaarden niet kan simuleren. Vertrouw niet op de editorpreview om te bevestigen of een widget werkt.

**Zo test je je upsell nauwkeurig:**

1. Zet de widget-trigger tijdelijk op **Show for all customers**
2. Plaats een echte testbestelling met de testbetaalgateway van Shopify (of een kortingscode die de bestelling gratis maakt)
3. Bevestig dat de widget verschijnt tijdens de daadwerkelijke checkoutflow
4. Reset je triggers na het testen

***

<div id="nothing-above-applies">
  ## Niets van het bovenstaande is van toepassing
</div>

Heb je alles hierboven doorlopen en wordt de upsell nog steeds niet weergegeven, bevestig dan het volgende:

* De widget is **ingeschakeld** in Aftersell en het app block is **toegevoegd en opgeslagen** in de Shopify Checkout Editor
* De **plaatsing** in Aftersell komt overeen met de in Shopify geselecteerde plaatsing
* De triggervoorwaarden matchen je testwinkelwagen — onthoud dat bij een **AND**-verbinding aan elke voorwaarde moet worden voldaan
* Er is minstens één widget met een trigger **Show for all customers** op de laagste prioriteit als catch-all
* Het upsell-product is **Active**, op voorraad en heeft (voor abonnementsaanbiedingen) actieve selling plans
* Je test met een **echte checkoutflow**, niet met de Shopify-editorpreview
* Probeer je browsercache te wissen of te testen in een incognitovenster — wijzigingen kunnen enkele minuten nodig hebben om door te voeren

Nog steeds niet opgelost? Neem contact op via de chat of mail ons op [support@aftersell.app](mailto:support@aftersell.app) en voeg een beschrijving van je widgetsetup en de details van de testbestelling toe.
