Skip to main content

Offering subscription upgrades in the cart

Let shoppers switch a cart item to a subscription using selling plans from your subscription app, with every setting, its default, the tokens for plan names, and what shoppers see.

Written by Grace

Subscription upgrades put a button under cart items that shoppers can buy on subscription, so they can switch an item from a one-time purchase to a recurring order without leaving the cart. Atlas shows the subscription plans your products already have. It doesn't create them: the plans come from a subscription app, such as Shopify Subscriptions or Recharge, and a product with no plan shows no button. By the end of this you'll have the button showing for the products that have plans.

In this article:


What you need first

A subscription app, with selling plans (subscription plans) on the products you want to offer. The panel always shows “Needs selling plans.” with “Upgrades only appear for products with selling plans from a subscription app such as Recharge or Shopify Subscriptions.”

⚠️ Atlas doesn't create, price or manage subscription plans. If a plan's frequency, price or renewals are wrong, change them in your subscription app.


How to offer subscription upgrades

  1. Open your cart upsell in the editor and click Subscription upgrades, under Upsells.

  2. Switch it on with the switch at the top of the panel.

  3. Change any of the texts, if you want to (see the table below).

  4. Decide whether to turn on Prevent downgrades.

  5. Click Publish.


The settings

The panel has no sections. Each Override setting is a switch: while it's off, shoppers see the default text; switch it on and a text box appears, filled with that text for you to change.

Setting

Default text

Limit

What it changes

Override button text

Upgrade to {selling_plan_group_name}

100 characters

The button under the item. Help text: “Use {selling_plan_group_name} for the plan group name.”

Override dropdown text

{selling_plan_group_name} / {selling_plan_name}

150 characters

Each plan in the list the button opens. Help text: “Use {selling_plan_group_name} and {selling_plan_name} for the plan names.”

Override one-time purchase text

One-time purchase

50 characters

The list's option for keeping the item as a one-time purchase. Help text: “Label for keeping the item as a one-time purchase.”

Prevent downgrades

Off

None

Hides the one-time purchase option from the list. Help text: “Once subscribed, hide the option to switch back to one-time.”

  • Tokens: {selling_plan_group_name} is replaced with the name of the plan group in your subscription app (for example "Subscribe & Save"), and {selling_plan_name} with the plan's name (for example "Deliver every 2 weeks").

  • An override reads as on whenever its text is different from the default. Switching it off puts the default text back.

  • A text box can't be left empty. An empty one stops the cart upsell saving, with “Enter the subscription upgrade button text.”, “Enter the subscription upgrade dropdown text.” or “Enter the one-time purchase text.”, even while subscription upgrades are switched off.

Use the overrides when your app's plan names are internal or unclear. A plan called "SUB-30D-STD" in your app shouldn't reach shoppers as it is.

⚠️ Think twice before turning on Prevent downgrades. A shopper who switched to a subscription by mistake and can't switch back is more likely to leave the cart than to keep the subscription.


What shoppers see

  • The button shows under each item whose product has a selling plan, and only there. It uses your checkout button's colours and corner radius, which you set in Colors.

  • The button's text names the product's first plan group where you wrote {selling_plan_group_name}, for example "Upgrade to Subscribe & Save". Once the item is on a subscription, the button shows the chosen plan's name there instead.

  • Opening the button lists the one-time purchase option first (unless Prevent downgrades is on), then the plans in each plan group the product has, written with your dropdown text: up to 10 plan groups, with up to 10 plans each.

  • Choosing a plan changes that item in the cart to the subscription.

In the editor's preview, the button sits under the first sample item. While the panel is open, its list opens with sample plans: Subscribe & Save, Deliver every 2 weeks and Deliver every 4 weeks. On your store, shoppers see your real plans.


Why the cart is a good place for this

On a product page, a shopper is still deciding whether to buy at all, and a subscription offer asks for a second decision. In the cart, they've already decided, so switching to a subscription is one small choice, framed as a saving on something they're buying anyway.

💡 Lead with what the shopper gets. "Subscribe and save 15%" says more than "Upgrade to subscription".

If the button doesn't appear for a product, see Why aren't subscription upgrades showing in the cart?

Did this answer your question?