Post-purchase upsells within Shopify checkout

New Member
1 0 1

Hello All,

I am wondering how is doing post-purchase upsells within native Shopify's checkout.

I was not able to find any API documentation on that. Are they doing redirect scripts on thank-you page?

Or this is upcoming Shopify's API to allow us to do such thing?

Will love to get insights on this,


Thanks alot,


Shopify Partner
102 15 17

Did you actually get to see this in action?


yes i noticed it today i'm also seeking for these functionality API.



Shopify Partner
12 0 3

Have been searching for information too...


It was announced as new integration feature for apps? About 8 apps already use this and I guess they have been invited a while back. But apparently it is now available in the API? But where? Couldn’t find it...


Any ideas?

Shopify Partner
102 15 17

I cant find any documentation. I tried shopify support but no clear answer so far.

Shopify Partner
1867 182 777

Hi @all

Oh boy I am glad you mention this.

So let me recap what's happened regarding this entire announcement from 11/02.

  • Shopify announces Subscriptions API and mentions Upsell API (only a few noticed, no real info yet)
  • Shopify begins accepting applications for a public beta of Subscriptions API which are set for GA somewhere 01/2021
  • Shopify announces select app vendors are shipping their apps using still in beta Subscriptions API and some app vendors using Checkout extensions / Upsell API which is still closed beta and there never was a public invite for app devs / partners. They reason that the selection criteria was based on experience, market fit and exposure yada yada... when you put it through corporate lingo translator it yields "you're not a celebrity or rich so suck it up and wait"

Now then, those lucky few who were part of the closed beta not only had the toys to play around with before everyone else, they also get to use them +2 months sooner than anyone else. Not only the Subscriptions API, but the all elusive Upsell API or whatever it will be (uses Argo with the Checkout extensions which Shopify isn't giving away to mere mortals here).

Wait what?

Yeah, so we as developers, as partners and as app vendors are put at a considerable disadvantage and loss of opportunity which translates in to $$$. Not only are the apps that can already use Subscriptions API or Checkout Extensions available for use on app store, Shopify even created specific app categories and labels (works with Shopify Checkout) to promote them on the app store. And if you thought that wasn't enough, Twitter, Shopify blogs, Shopify documentation have all been plastered with the big news and promotions for the very few select apps which can use APIs that have not yet been released.

Great going Shopify :applauding: Love you dearly but you sure know how to hurt real well.

Here's what I'd suggest:

  • Shopify retract general availability of the apps using these non public features as it's creating unfair market conditions.
  • Of course, some vendors may be better suited for closed betas and that's fine. I fully understand that. Have their apps with the Subscriptions API and Checkout Extensions only work for some of their customers upon request so that Shopify can test the new bits and collect feedback, fix issues, improve the developer, merchant and customer experience.
  • Once ready do a public beta so the rest of us have time to catch up.
  • Then go for GA

But what's been done here and been celebrated so cheerfully is quite a let down... I can't even be happy that these features are actually arriving or mention all the friggin' amazing work done by @lemonmade aka Chris Sauve and others with remote-ui, argo, argo-admin-host, argo-checkout and tying it all up with Shopify CLI for a great DX. Dammit, it's such nice code and architecture it makes me want to cry... yet here I am sort of crying in the forums because of all I mention above.


Liked this post? You might also like our fantastic upsell apps Candy Rack and Candy Cart or offer free gifts with Gift Box. All made with ❤️  and care by Digismoothie
Shopify Partner
102 15 17

It sucks that they would do that.

Thanks for all the info.

Shopify Partner
12 0 3

Thank you for the information!


Typical. The ecosystem seems to be getting segmented into insiders who are preferred and the rest. Wouldn’t be surprised if even search results in the app store are influenced by some unofficial insider status, but we’ll never find out.


At the same time, it’s Shopify’s own platform, so they can do as they please. Seems natural development, the bigger a platform becomes. 


Shopify Partner
1867 182 777

Now let me be a little less critical and hurt and summarise what we can do.

We can use Subscriptions API beta if we have filed for public beta access and have been granted access for one of our dev apps. This API is well documented in GraphQL Admin API reference docs and the developers portal tutorials provide fantastic step-by-step walk throughs how to get going with subscriptions.

Subscriptions are basically a few parts we as app devs must be aware of:

  1. Create an Argo admin extension for the subscriptions extension point using Shopify CLI, register it with your app that's been granted beta access, push it and go publish it in your app dashboard. Under the hood, Argo for admin uses argo-admin-host which in turn uses several bits of remote-ui facilitating the entire architecture where Argo extensions are assembled on a a separate thread (web worker) and then pushed to the UI thread of the host i.e. the extension you created, registered, pushed and published before is actually run within Shopify admin and hosted by Shopify. Very cool stuff! Depending on the extension points, we will be able to have our app specific UIs mingling directly within product forms, order forms etc. I mean this is really really cool not just in terms of Shopify. remote-ui is simply a marvellous piece of code with use-cases far beyond the Shopify ecosystem!
  2. This should allow merchants to configure subscription groups, plans and associate them to products. Of course, you should also provide merchants the ability to manage not just subscription groups, plans but also actual subscriptions. That's up to your app and go crazy with Subscriptions API et al.
  3. Next, the theme itself must enable subscriptions i.e. the product page section must have some extra Liquid to pickup on subscription plans available to that product to display the options to the customer. How you handle that is also entirely up to you and classic Liquid fidgeting around with. Or your app provides a more up to date UI using JS. Up to you. If the product can only be sold as aa subscription it doesn't matter as the subscription will be automatically created if the product is added and checked out.
  4. Any subscription app should also provide the means for customers to view and edit their subscriptions so they can review or change them.

Anyhow, that's a short recap for Subscriptions API and Argo for Admin with subscriptions.

It is still in public beta, ETA for GA is sometime early 2021 unless you're one of the privileged app vendors already using it because... oh never mind :cringe:

Then there's post-purchase upsell or Upsell API or Argo for Checkout - no idea what they're all officially called. They're closed beta i.e. the stuff I am angry about for how Shopify has handled it for the rest of us.

This little beauty essentially allows customers to receive product offers right within checkout after they've entered their card details but before the thank you (order status) page. What's real neat about this is if they opt-in to the offer, they do not need to enter their payment details again (as is possible now using Order Edit API). This ladies & gents is true upselling that rocks aand is why this is such a BIG deal. You just had your customer buy something, you already have their card details, you peddle them another offer, a cool upsell that makes sense and has a good discount. One click is all it takes for them!

This in turn, as far as I am able to tell for now largely uses  Argo for Checkout i.e. we now have a host in checkout that can display Argo extensions at a predefined checkout extension point. It can display within right / left or footer, has a bunch of useful pre-defined UI components for vanilla JS or comes with React wrappers, Preact is being worked on because React is heavy and there's nothing stopping you using whatever you like (hypertext tagged markup, svelte, whatever). You can call your apps APIs and do something to add that offer to the existing order. It is that something which is elusive because current Edit Order API cannot capture another payment without the customer having to go through a new payment card entry. I suppose this is some API feature we know nothing of yet.

Anyhoo... if you want to play around with Argo for Checkout you cannot because... oh never mind, I'd be repeating myself :cringe:

But if you want to simulate playing with Argo for Checkout you can because somewhere within the Argo docs there was a link to the Argo sandbox environment which can be found and used (Shopify dev confirmed this) at That at least hosts your little argo for checkout extension for the Checkout::PostPurchase::Render extension point (that's that page in-between payment details form and thank you page).

So just fire up Shopify CLI and 

> shopify create extension
... select 'Checkout Post Purchase'
... enter extension name 'my-cool-checkout-extension'
... pick React + TS or whatever floats your boat
... sip some coffee
> cd my-cool-checkout-extension
> shopify register
... authenticate yourself
... selected one of your dev apps
... all good so far... have another sip of coffee
> shopify push
... says all is good and get some link to follow to version and publish your extension but it won't work


Ah yes it won't work because... you know by now.

So just hit

> shopify serve


to serve the extension locally, open up an HTTPS tunnel in ngrok and run over to to check it out.

Let's just document this as much as we can here and share info / learn together since we aren't celebrities or rich enough to have been invited to the party.



Liked this post? You might also like our fantastic upsell apps Candy Rack and Candy Cart or offer free gifts with Gift Box. All made with ❤️  and care by Digismoothie
Shopify Expert
148 0 26

I think you guys made a good recap of how every other plebs developers feel right now. Anyone knows when the next API release will be available, and the Upsell API docs (currently hidden to plebs like us)