Docs/Shops/Post-purchase upsell

Post-purchase upsell#

Show a one-click product offer after payment and before the Thank you page. The buyer can accept with the payment method already on file — no second checkout. You decide what is offered, to whom, and when, with upsell flows in the Karla app.

Recommended for: Marketing, E-commerce managers

Want to show offers before payment, inside the checkout itself? See Checkout upsell.

What you get#

  • A one-click upsell on Shopify's post-purchase page
  • Upsell flows — offer different products depending on what the buyer bought, who they are, and how much they spent
  • Up to two offer pages per flow: a first offer with optional backup products and an A/B test, then an optional second offer everyone reaches, which can differ for buyers who said no
  • Featured products, bundles, products from a collection, each product's own paired product, or what your customers bought together with the order as the offer
  • Per-offer discounts and quantities
  • Advertorial pages — your own text and images around the offer
  • Offer page texts in your own words, per language
  • A preview of each flow before it goes live
  • A Performance tab with revenue by offer type

Prerequisites#

  1. Install the Karla Shopify app and complete onboarding.
  2. Pick at least one offer in the Karla app — or keep an active manual product promotion in the Karla portal, which the default flow uses when you have not picked a product. Offers you pick yourself serve without any promotion.
  3. Buyers must pay with a method that supports post-purchase offers (card / Shopify Payments). Shopify skips the post-purchase page for some methods, such as cash on delivery and certain wallets. See also PayPal below.
  4. Upsells must be enabled for your shop. If the Upsells page in the Karla app says to reach out to your customer success manager, ask them to enable Upsells for you. Shops connected before 17 October 2026 keep upsells enabled.

Setup overview#

StepWhereWhat you do
1Karla app → UpsellsBuild your flows and settings
2Shopify admin → CheckoutSet the post-purchase page to Karla and save

Configuration lives in the Karla app. Activation is a one-time choice in Shopify checkout settings. After that, you can change offers yourself — no Karla implementation work required.

The Upsells page#

Open Shopify admin → Apps → Karla and click Upsells in the app navigation. The page has three tabs:

TabWhat you do there
Upsell flowsSee the activation status, build and order your flows, edit the default flow
SettingsProduct exclusions, offer page texts, deal and countdown, paired product field
PerformanceSee how each offer converts and what it earns

The Settings tab also holds the pre-purchase checkout upsell.

Activation status#

The top of the Upsell flows tab tells you whether your upsell is live:

StatusMeans
LiveKarla served a post-purchase offer to a buyer within the last 7 days
Not live yetOffers are configured, but no buyer has seen one in the last 7 days — check that Karla is selected in Shopify checkout settings
OffNothing is configured yet

Open Shopify checkout settings takes you straight to Step 2.

Step 1: Build your flows#

How flows work#

The Flows list shows your flows in the order Karla checks them. For each order, Karla walks the list from the top and uses the first flow that matches — its conditions, audience, and order value all fit. Use Move up / Move down in a flow's ⋯ menu to change priority.

The Default flow is pinned at the bottom. It runs when no flow above it matches, and it cannot be switched off, renamed, or deleted.

From the list you can:

  • Filter by All, Active, or Inactive
  • Switch a flow on or off with its toggle
  • Duplicate or Delete a flow from its ⋯ menu (deleting a saved flow asks you to confirm; buyers it matched get the default flow instead)
  • Click Create new flow — up to 20 flows

A new flow is saved off. It only reaches buyers once you switch it on, so a half-built flow never goes live by accident. Flows that are off show an Off badge.

Build a flow#

Click Create new flow (or the edit icon on a flow) to open the builder. Give the flow a name, then set up each card from top to bottom.

Schedule (optional)#

Under the flow name, set a Start date and an End date to run the flow for a limited time — for example a Black Friday offer that goes live and stops on its own, with no save needed at either moment.

  • Dates and times are in your shop's time zone. If Karla can't read your shop's time zone, UTC is used.
  • Start time and End time are optional. Leave the start time empty to start at the beginning of the day, or the end time empty to run until the end of the day.
  • You can set only one side: a start date with no end runs indefinitely once it starts, and an end date with no start runs from now until then.
  • The end must be after the start, or the flow can't be saved.

A schedule only applies to a flow that is switched on. Outside its window the flow is skipped and Karla checks the next one, the same as for a flow that is off. In the Flows list, a scheduled flow shows Starts with its start date, Live until with its end date, or Ended.

Settings · Who gets this flow#

The audience, the trigger conditions and the product exclusions sit in the Settings card at the top of the flow. It shows them as a three-line summary; click Edit settings to change them and Done to fold the card again. A new flow opens with the card expanded. Under it, the flow reads as the pages a buyer sees: Page 1 · First offer, Page 2 · Second offer (optional) and the Thank-you page. A line above the cards says how many offer pages and products a buyer can meet, and a badge says Ready to go live or lists what is still left.

Audience#

Who this flow is for:

  • Buyer type — All customers, First-time customers, or Returning customers. A buyer Shopify passes without a customer ID counts as a first-time customer. If Karla can't look up a buyer in time, flows with a buyer type are skipped.
  • More audiences (shown when your shop has CRM segments) — pick segments from your Klaviyo segments, Klaviyo lists, and Shopify tags:
    • Only customers in — the flow runs only for buyers in at least one of these segments
    • Exclude customers in — the flow is skipped for buyers in any of these segments. It is also skipped when a buyer's segments can't be checked, so an excluded buyer never sees it by mistake.
  • Product exclusions — click Edit product exclusions to pick products, collections, or product tags (tabs Products, Collections, and Tags) that stop this flow: when the order contains one of those products, a product from one of those collections, or a product with one of those tags, Karla skips this flow and checks the next one. Tags ignore upper/lower case. A flow can exclude up to 50 products, collections and tags.

All audience settings apply together with the trigger conditions below.

Trigger conditions#

What the order must contain for the flow to run. A flow needs at least one product or collection condition, a buyer type or segment in its audience, or an order-value condition — to reach every order, use the default flow instead.

  • Each condition is a list of products, specific variants, or collections — click Edit and then Select products or Select collections. The condition is met when the order contains any of them.
  • Minimum quantity (optional) — set a whole number from 1 to 999 to turn the condition into At least N items from its products and collections. Quantities of all matching items in the order count together, e.g. 3 for three bags from one collection. Leave it empty to match any quantity. To build quantity tiers, put the flow with the higher minimum above the flow with the lower one — the first matching flow wins.
  • Click Add another condition → Add product condition or Add collection condition to add more. With more than one condition, choose whether the order must match Any or All of them.
  • Came from a link (UTM) — under Add another condition, route buyers who arrived through a specific link into this flow, e.g. one flow per ad or advertorial. Pick the parameter (utm_id, utm_campaign, utm_source, utm_medium, utm_content or utm_term), choose contains or is exactly, and enter the value — matching ignores upper/lower case. The condition reads the link the buyer came through in this session, including cart links such as /cart/123:1?utm_id=upsell_bc3. It combines with the other conditions like any other — choose All for "bought X and came from this link". A buyer without that UTM falls through to the next flow. The link is forgotten once the order completes, so a second order in the same tab only matches if the buyer comes through a UTM link again.
    • Needs the Karla pixel, switched on under Settings → Attributions; the builder warns you when it is off. With a consent requirement set there, buyers who decline are not matched — and buyers who open a cart link go straight to checkout without ever seeing your cookie banner, so they are never matched either. For link routing to work, set the pixel's consent requirement to No consent required (for link routing the pixel stores only the link's utm_* values and a checkout token), or accept that only buyers who consented on a storefront page are routed.
    • Express checkouts that skip the checkout page (Shop Pay, Apple Pay and other wallet buttons on the product or cart page) can bypass the pixel, so those buyers fall through to the next flow.
  • When order value is more than… / When order value is less than… — limit the flow to an order total band. The total includes shipping and tax, in your shop currency; totals in other currencies are not converted. Tip: set the minimum to your free-shipping threshold to skip buyers who already paid for shipping, because an upsell does not refund it unless the offer uses Refund shipping.

The pages#

Each flow has up to two offer pages:

flowchart TD
  P1[Page 1 · First offer] -->|Added something or said no to everything| P2[Page 2 · Second offer]
  P2 --> T[Thank-you page]
  • Page 1 · First offer — the first page the buyer sees after paying. Required. (Upsell 1 in the step map and in reports.)
  • Page 2 · Second offer — optional. Click Add a second offer page to show one more product after page 1. Its offer is the Reward: with the switch off, everyone sees it, whatever they did on page 1. Switch on Different offers by answer to give buyers who said no to everything on page 1 their own Counter offer, for example a cheaper product or a deeper discount; buyers who bought something on page 1 see the Reward. Switching it off again shows everyone the Reward. Page 2 is the last offer: it has no backups and no A/B test. Remove page 2 takes the page away again.
  • Thank-you page — every path ends here; the buyer continues to the order confirmation with the products they added in the order.

In the step map, page 2 is the Reward on the path of a buyer who added something and the Counter offer on the path of a buyer who said no. On the Performance tab they show as Page 2 · Reward and Page 2 · Counter offer. With the split switched on, leave one of the two slots empty and buyers on that path get the default flow's second offer instead.

To fill an offer, click Add product and choose a source:

SourceWhat the buyer is offered
Featured productA product you pick. Select the whole product to let buyers choose their size or variant, or pick specific variants — with several, one of them is chosen per buyer. Picking several products creates a bundle.
Bundle productTwo to four products sold together as one offer, each with its own quantity (1–10), plus an optional Bundle title and Bundle description
Products from a collectionThe collection's best seller; if it is sold out, the next best seller
Paired productPage 1 only. The product that each purchased product names in its own paired-product field in Shopify — see Paired product source
Bought togetherPage 1 only. What your customers most often bought with the products in this order, else your best sellers; with neither, the default flow
Offer a product from this orderAn item from the buyer's own order again — choose The cheapest item or The most expensive item, ranked by what the buyer paid per item. Switch on Hide the variant they bought to offer another variant of the same product instead, like another size. Products on your never-upsell list and free items are skipped; if nothing qualifies, the default flow serves. Can't be previewed — place a test order to see it

If the product picker does not open, your staff account may lack the Products permission on this store — the app says so. Ask the store owner for it, then try again.

A page 2 offer cannot repeat page 1's product (different variants of one product are fine) — only the slot for buyers who said no may offer it again, for example at a deeper discount.

Discount and quantity. Each offer has a quantity field (1–10 units added in one click; a bundle sets a quantity per product instead) and Add discount: choose Percentage discount (1–100 %) or Value discount (an amount in your shop currency). For a percentage, Discount applies to sets the base: Current price (default) or Original compare-at price. With the compare-at base, the buyer pays the compare-at price minus the percentage. If the product is already on sale below that, the current price stays and no extra discount is added; a product without a compare-at price above its current price is discounted from the current price. Without a discount, the product is offered at its regular price — or at your promotion's discount if it is part of your active product promotion. A bundle on page 2 without its own discount uses page 1's.

Quantity tiers. On a single-product offer (not a bundle, upgrade, A/B version or backup) with a Percentage discount on the Current price, add Quantity tiers to give a bigger discount when the buyer takes more. The discount above is the rate for 1 item; click Add tier and set From quantity and Discount for each further tier — up to 4 tiers in all. Quantities must go up from 2 to at most 10, each with a discount between 1 and 100 %. The offer page then shows a quantity picker and updates the price as the buyer chooses.

Refund shipping#

On a single-product offer (not a bundle or upgrade, not an A/B version or backup, and not a percentage discount on the compare-at price), tick Refund shipping when this offer unlocks free shipping. If the buyer paid shipping on their order and the order plus this offer reaches Free shipping from (set on the Settings tab), the shipping they paid comes off this offer — up to the offer's own price. The offer page tells the buyer, for example Your shipping is now free, or how much of their shipping is refunded when it is only part of it. Nothing is refunded when the order was already at the threshold before the offer, or when Free shipping from is empty.

Shipping is refunded only in shops whose prices include tax. In a shop whose prices exclude tax the option is shown but switched off, because Karla can't separate shipping from tax.

If they say no on this page#

Page 1 can show up to two backup products on the same page before the buyer moves on. A common setup: page 1 offers a 3-pack, and if the buyer declines it, the same page shows a single unit instead.

Inside the Page 1 card, the If they say no on this page box holds these backups. Click Add Backup 1, then pick a product or a collection and set its own discount and quantity, as on any offer.

  • The buyer sees them one at a time, in order, each time they click No thanks. The countdown keeps running; it does not restart.
  • Adding one of them leads to page 2 like adding the first offer does. Declining the last one leads to page 2 as well — to the slot for buyers who said no, when the page has one of its own.
  • They use page 1's advertorial, with each product's own card. They have no advertorial of their own.
  • A product that is sold out, on your product exclusions, or already in the buyer's order is skipped.
  • With an A/B test on page 1, every version is followed by the same backups.
  • Backups are not available when page 1 is an upgrade or a paired product.
  • The preview walks them too: click No thanks on page 1 in the preview. The preview says Product 2 of 3 on this page, and the step map shows them as Backup 1 and Backup 2.

Advertorials#

Each node (except a paired product or bought together) can have its own advertorial: a page of text and image blocks around your offer. Click the advertorial (pencil) icon on a node to open Create an advertorial, then Add text (a Custom Headline and Custom Paragraph Text, with text size and alignment) or Add image (with Alt text for screen readers), and click Save advertorial. Nodes with one show an Advertorial enabled chip. Without an advertorial, the standard offer layout is used.

The default flow's Upsell 1 advertorial also appears on any flow whose first offer has no advertorial of its own.

A/B test#

To A/B test the first offer, switch on A/B test at the top of the Page 1 card. Page 1 then lists Version A — the offer you already had — and Version B, empty: pick a product or collection for it, and set its own discount and advertorial. Add Version C adds a third. Every version stays visible; there are no tabs. Page 1 must sell a product or collection as an add-on (not a bundle, paired product or upgrade).

  • The test starts when you save the flow. Until then you can remove a version or switch the test off again, and a version without a product, or one identical to Version A, blocks the save.
  • Buyers are split evenly between the versions, and each buyer keeps seeing the same version if the page reloads. Adding a version to a running test re-splits new buyers.
  • Once the test runs, a Results box under the versions shows each version's views, conversion rate, revenue and revenue per view. Results update hourly and get reliable at about 200 views per version.
  • Pause test shows Version A to everyone until you resume.
  • Keep A / Keep B under a version ends the test: that version becomes page 1's offer for all buyers and the others are removed. Results recorded so far stay in the flow's history. The switch cannot simply be turned off while a test runs — keeping one version is how it ends.
  • The flow list shows a Testing badge while a test runs.

Save the flow after starting, pausing or ending a test.

Save and switch on#

Click Save flow (or Create new flow on a new one). The save bar at the top of the page also saves your changes. Then switch the flow on with the toggle next to the save button, or from the flow list.

Preview a flow#

Click Preview flow to see a simulation of the post-purchase page with the flow's real products, prices, and texts — including changes you have not saved yet. On a wide screen the preview opens in a pane next to the flow and updates as you edit; editing a step shows that step. On a smaller screen it opens in a window. Switch between Desktop and Mobile, click through accept and decline, or click a step in the map at the top to jump to it.

The pane starts on Mobile, since most buyers see the page on their phone. Click the expand icon in its header to open the same preview in a large window on Desktop; closing the window takes you back to the pane.

The preview header says where you are in the buyer's terms — Page 1 of 2, Product 2 of 3 on this page for a backup, and After adding something on page 1 or After saying no on page 1 on page 2.

When page 1 has an A/B test, the header also says Previewing as a buyer in Version A with a Switch to B (and Switch to C) button. Switch to see that version's product, deal and advertorial, without saving or placing a test order; page 2 follows as usual. The preview and the version rows stay in step: editing a version in the flow shows that version in the preview, and the other way round. Once you keep a version, the line goes away and the preview shows the winning offer.

  • Flows with a minimum or maximum order value or an item count show a Sample order button: enter an order total (and optionally a bought product) to see whether the flow fires for that order.
  • The preview starts in Shopify's default checkout look. On Shopify Plus stores, click Show my checkout branding under it and approve the access request to use your store's checkout branding instead. The colours of buttons, links and background follow your checkout branding; text shades may differ slightly. Fonts are set the same way the live page sets them. Shipping and taxes are not shown.
  • Flows that offer a paired product or a bought-together product can't be previewed, because the offer depends on a real order.

The default flow#

Click the edit icon on the Default flow row to open it:

  • Audience — All customers (default), First-time customers, or Returning customers. This setting is shop-wide: Karla checks it before any flow, so a buyer outside it sees no offer at all. A buyer Shopify passes without a customer ID counts as a first-time customer, so Returning customers skips them. When Karla can't look up a buyer that has a customer ID in time, they still see the offer.
  • Trigger conditions — fixed: Any order — this flow runs when no other flow matches.
  • Upsell 1 — Featured product, Bundle product, or Paired product (when the paired product field is set). With nothing picked, it offers the first product of your active promotion. You can also upload an Offer image (PNG, JPEG, WebP, or GIF up to 2 MB) to show instead of the product image.
  • Upsell 2 — the default second offer, shown after Upsell 1 is accepted or declined. Click Add a second offer, then choose:
    • Select second offer product — a product you pick; without one, it offers the next product of your active promotion
    • Bundle product — a bundle, with one deal on the bundle total
    • Select second offer collection — a product from a collection
    • Use the same collection as the first offer — another product from the collections the buyer's purchased products belong to, skipping what they already bought and what the first offer showed
    • Number of products (1–3) — with two or more, buyers see a small product grid

The default second offer is also what any flow falls back to on page 2 when the slot for that path is empty (Reward or Counter offer).

Settings tab#

Most post-purchase settings here apply to every flow — the exception is the Deal discount and quantity, which belong to the default flow. The checkout upsell section at the bottom saves on its own; everything else is saved with the save bar at the top.

PayPal#

If you accept PayPal, a PayPal setup required card may appear at the top of the tab. Shopify skips the post-purchase page for PayPal orders until PayPal approves Reference Transactions for your account — buyers paying by card are unaffected. Use To payment settings and How to enable PayPal Reference Transactions to request it. While PayPal is still reviewing, the card says so and no action is needed.

Product exclusions#

  • Add products to exclude — these products are never offered in any upsell. Excluding a product covers all of its variants, including ones you add later. Up to 50 products.
  • Add collections to exclude — products from these collections are never offered. Up to 50 collections.
  • Never upsell products tagged — type a product tag and press Enter; products with that tag are never offered. Letter case does not matter. Up to 50 tags.
  • Skip offers low in stock — skip a product variant whose tracked stock is below the number in Skip when fewer than this many are in stock, as if it were sold out. Oversold variants count as low; variants that don't track stock are always offered.
  • Skip items if already in the order — don't show an offer when the offered variant is already in the buyer's order. Karla removes those offers before the page renders: if Upsell 1 is removed, buyers may land directly on the next step; if every offer is removed, the page is skipped. Leave it off if you are happy selling extra units of something already in the cart at a discount — that often converts well.

Customise offer page#

Write the offer page in your own words:

FieldWhere it appears
HeadlineMain heading of the offer page — supports variables (see below)
SubheadingSupporting line under the headline — supports variables (see below)
Urgency lineThe countdown sentence — use {time} where the ticking clock should go
BadgeShort label above the product title (e.g. "Bestseller"); empty = no badge

The Default tab holds your main texts. Click Add new language to add a translation for another buyer language; empty fields in a language tab use the text from the Default tab, and empty fields on the Default tab use Karla's built-in text in the buyer's language. Advertorial blocks and bundle titles are not translated yet.

Variables. The Headline, the Subheading and the text blocks of an advertorial can use variables — type them, or use Insert variable:

VariableShows
{first_name}The buyer's first name
{first_name|there}The buyer's first name, or "there" when the checkout has none
{savings}What the offer saves — empty when it saves nothing; on a page with 2–3 products, the first product's savings

Deal#

The discount and quantity for the default flow's Upsell 1 — the same values you see on that node:

SettingOptions
DiscountPromotion discount (default), Percentage, or Fixed amount
Discount valuePercent (1–100) or fixed amount in your shop currency
Discount applies toPercentage only: Current price (default) or Original compare-at price
QuantityUnits added in one click (1–10; default 1)

A discount set here replaces the promotion discount on the post-purchase page. Flows use the discounts set on their own nodes.

The same card holds:

  • Free shipping from — your store's free-shipping threshold, in your store currency. Offers with Refund shipping use it. Leave it empty to turn the refund off.
  • Countdown — an urgency countdown on the offer page (1–60 minutes, 10 by default). One clock runs across all offer steps; when it runs out, the page closes and the buyer continues without the offer.
  • Progress bar — a checkout progress bar on the offer page, so it reads as a checkout step.

Paired product source#

Name the Shopify product metafield that stores each product's paired upsell product — Paired product metafield namespace (for example custom) and Paired product metafield key (for example upsell_product). Find both on the metafield definition in Shopify admin → Settings → Custom data → Products. Use the key, not the field's display name — a wrong key finds nothing and no offer is shown.

Once set, the Paired product source becomes available on Upsell 1. Each buyer is then offered the product that their purchased product points to. When the purchased product's field is empty, there is no paired product to offer.

Performance tab#

The Performance tab shows how your post-purchase offers do over the last 7, 30, or 90 days:

  • Total revenue — upsell revenue for the period, compared with the previous period of the same length
  • Revenue breakdown by offer type — Featured product, Bundles, Paired product, and Collection, plus Bought together once a flow has offered one
  • A table per offer with Shown, Accepted, Accept rate, Confirmed, Confirmed rate, Merchandise value, Apply failures, and Abandoned
  • A hint when your most-shown offer is not your best-converting one
  • For an offer that ran in an A/B test, Show versions lists each version with its Views, Conversion, and Revenue per view

Merchandise value is counted at the offer price, before shipping and tax, so it reads lower than the amount you collected. For the collected amount, filter your orders by the tag karla-post-purchase-upsell.

Step 2: Activate on the Shopify post-purchase page#

Configuration alone does not show the page. You must assign Karla as the post-purchase app:

  1. In Shopify admin, go to Settings → Checkout.
  2. Scroll to the Post-purchase page section.
  3. Select Karla / Karla Post-Purchase Upsell (the label Shopify shows once the Karla app is installed).
  4. Click Save.

Shopify shows an unsaved-changes banner after you select the app. The extension does not go live until you press Save.

If another app or custom code already owns the post-purchase page, switching to Karla replaces it for that slot. Only one post-purchase app can be active at a time.

What buyers see#

On the post-purchase page, buyers typically get:

  • A short personalized greeting when their first name is known
  • The offer product (image, price, discount badges when applicable), or your advertorial around it
  • For a bundle, an image of every product in it and an Includes: list
  • A Choose an option selector when the offered product has several variants — buyers pick their size or color before accepting
  • Star ratings / review count when your catalog has standard reviews.rating / reviews.rating_count metafields (e.g. Judge.me, Loox)
  • The optional countdown and progress bar
  • A price summary with subtotal, discount, shipping, and taxes — when the buyer paid shipping on the original order, it states up front that already-paid shipping costs will not be refunded (accepting the offer never recalculates the original shipping line, even across a free-shipping threshold), unless the offer refunds shipping, in which case the summary shows a Shipping refund row instead
  • Add to my order (charges the payment method on file) or No thanks, continue

Accepting or declining Upsell 1 moves the buyer to the next step of the flow (single product or grid). A sold-out variant is swapped for an in-stock variant of the same product, or left out.

How offers are chosen#

flowchart TD
  A[Buyer completes payment] --> B{Post-purchase page = Karla?}
  B -->|No| Z[Thank you page]
  B -->|Yes| C{Default flow audience allows buyer?}
  C -->|No| Z
  C -->|Yes| D{First active flow that matches?}
  D -->|Found| E1[That flow's Upsell 1]
  D -->|None| E2[Default flow's Upsell 1]
  E1 --> F{Accepted or declined?}
  F -->|Accepted| G1[Reward]
  F -->|Declined| G2[Counter offer]
  E2 --> H[Default second offer, if set]
  G1 --> Z
  G2 --> Z
  H --> Z
  • A flow matches when its trigger conditions, audience, order value, and product exclusions all fit the order. The first match wins.
  • An empty Reward or Counter offer falls back to the default second offer.
  • Excluded products and — with Skip items if already in the order — products already in the order are removed before the page renders.
  • If nothing is left to offer, the post-purchase page is skipped.

How accepted offers appear in Shopify#

Accepting the offer edits the buyer's original order — there is no second order and no second checkout:

  • The offered product is added to the order as an extra line item, and the payment method on file is charged for the difference.
  • Karla counts the conversion only after Shopify confirms the order edit was actually committed, so reported upsell numbers reflect real order changes.
  • Orders with an accepted offer are tagged karla-post-purchase-upsell — filter your Orders list by that tag to see every upsell conversion.

Like any order tag, karla-post-purchase-upsell also becomes a Karla segment (Shopify.tag.karla-post-purchase-upsell), so you can target upsell buyers in campaigns and A/B tests.

When the upsell charge does not go through#

The offer edits the order and charges the card on file as two separate steps. Shopify can edit the order successfully and still fail the charge — not enough funds, or a card that needs the buyer to confirm. The added line item is on the order either way, so a system that reads only the line items will ship and invoice an item nobody paid for yet.

Karla marks those orders:

TagMeans
karla-post-purchase-upsellThe upsell was accepted and the order was edited. Always applied.
karla-post-purchase-upsell-unpaidThe upsell was added to the order but the order was not fully paid. Check the order's financial status for the outcome.

The second tag is added in addition to the first, never instead of it, so your existing filters and segments keep working.

Karla decides it by reading the order's financial status from Shopify, not by trusting what the buyer's browser reported — anything other than Paid or a refunded state counts as unpaid.

It is a snapshot of the moment the order was tagged, not a verdict: Shopify may still collect the charge afterwards, for example once the buyer confirms the payment on the order status page. The tag is never removed, so for the settled answer always read the order's current financial status — the tag only tells you which orders to look at.

Flow recipe: hold an unpaid upsell#

Use Shopify Flow to stop an unpaid upsell reaching fulfilment or your ERP:

  1. Trigger — Order tags added.
  2. Condition — tag is equal to karla-post-purchase-upsell-unpaid.
  3. Condition — order financial status is not Paid.
  4. Actions — pick what fits your setup:
    • Send internal email to your fulfilment or finance team.
    • Add order tag with whatever value your ERP filters on (for example do-not-fulfill), so the order is skipped on the next pull.
    • Add order note recording why the order is on hold.

Add a second Flow on the Order paid trigger that removes the hold tag again, so an order settles back into your normal process once the charge clears.

Flow can read order financial status directly, without any Karla tag. If you would rather gate every partially paid order — upsell or not — build on that instead, and use the Karla tag only to tell upsell-caused cases apart.

Test before going live#

  1. Use Preview flow to check each flow's products, prices, and texts.
  2. Place a test order paid with a card (or Shopify Payments test mode) that matches the flow you want to test.
  3. Confirm the post-purchase page appears with the right product, price, and discount.
  4. Accept the offer and verify the order is updated with the extra line item and tagged karla-post-purchase-upsell.
  5. Repeat and decline, to check the Counter offer step.
  6. Repeat with a first-time vs returning customer if you use audience targeting.

Changing the offer later#

You can self-serve without Karla involvement:

ChangeWhere
Offer a product based on cart contentsUpsells → Upsell flows → create or edit a flow
Change which flow winsUpsells → Upsell flows → ⋯ → Move up / Move down
Pause a flowUpsells → Upsell flows → the flow's toggle
Change the fallback offerUpsells → Upsell flows → Default flow
Change who can see any offerUpsells → Upsell flows → Default flow → Audience
Never offer certain productsUpsells → Settings → Product exclusions
Rewrite or translate the page textsUpsells → Settings → Customise offer page
Change the countdown or progress barUpsells → Settings → Deal
Update the promotion productsPortal → edit the active product promotion
Turn the surface offShopify → Settings → Checkout → Post-purchase page → None

Troubleshooting#

Post-purchase page never appears

  • Confirm Post-purchase page is set to Karla and saved under Settings → Checkout.
  • Pay with a supported method (card / Shopify Payments). COD and some wallets skip the page, and so does PayPal until Reference Transactions are approved.
  • Make sure there is something to offer: a picked product in a flow or the default flow, or an active manual product promotion for the default flow to fall back on (dynamic product promotions are never used here).
  • The default flow's Audience may exclude the test customer (try All customers while testing).
  • Product exclusions or Skip items if already in the order may have removed every offer.
  • Orders under Shopify's minimum for post-purchase offers may skip the page.

A flow doesn't show

  • Check that the flow is switched on (no Off badge).
  • Check that no flow above it matches the same order — the first match wins.
  • Check its audience, order-value band, and product exclusions against your test order.
  • For a Came from a link (UTM) condition, check the Karla pixel is on and open the link in a fresh browser tab — and complete checkout on the checkout page rather than with an express-checkout button.

Wrong product or discount

  • Open the flow in the builder and check each node's product and discount.
  • For the default flow, confirm which product promotion is live in the portal.

Offer shows a product already in the cart

  • Enable Skip items if already in the order, or offer a complementary product instead.
Was this helpful?