Skip to content

Cart line editor

Customers often reach checkout and realize they picked the wrong size or quantity, or would rather subscribe. The cart line editor puts buttons under each item in the order summary so they can fix it, or add to it, without going back to the cart. There are two versions.

Block What customers can do Plan
Cart line editor Change the variant or quantity, remove the item, add a product that goes with it, or switch it to a subscription Buddy
Cart line editor (simple) Plus and minus quantity buttons Free

Both require Shopify Plus.

The editor shows under every item. To show it only for some items, use conditions such as Target line item tags. See target conditions.

The cart line editor has up to three buttons under each item. Turn on the ones you want; the editor’s Preview shows them as you change the settings.

Button What it opens When it shows
Edit Change the variant or quantity, remove the item, and optionally subscribe Whenever the checkout lets customers change items
Add-on A product that goes with the item, with an Add button When the item has complementary products in Shopify’s Search & Discovery app, and none of them is in the cart yet
Subscribe A delivery schedule and quantity, with a Subscribe button When the item has subscription plans and isn’t a subscription yet

Add-on and Subscribe do what the older Line item upsell did, and one cart line editor can show both, next to Edit or on their own.

The cart line editor’s Edit popover open, with the variant dropdown, Subscribe & save checkbox, quantity stepper, and Remove button

The Edit popover has:

  • A variant dropdown, when the product has more than one variant. Sold-out variants aren’t offered.
  • A subscribe checkbox, when you turn it on and the product has subscription plans. With more than one plan, a plan dropdown appears.
  • A quantity stepper. Setting it to 0 removes the item.
  • A Remove button.

The Add-on popover shows the first complementary product you’ve set up for the item in Shopify’s Search & Discovery app, with a variant dropdown if needed. Its button adds one to the cart and shows the price, for example “Add • $12.00”. The Add-on button hides once one of the item’s complementary products is in the cart.

The order summary with ‘Subscribe & save’ under a product and its popover open, showing the plan dropdown, quantity, and Subscribe button

The Subscribe popover lists the item’s subscription plans and a quantity, starting at the item’s quantity. Clicking the button turns that cart item into a subscription; it doesn’t add a new product. The Subscribe button then hides, because the item is a subscription.

Buttons

Setting What it does
Button style Pressable text, Primary button, Secondary button, or Plain link, for every button
Button layout Same row, wraps if needed, Always same row, or Always stacked. Shows when more than one button is on.
Add-on and Subscribe popover button style Primary button or Secondary button inside those popovers
Text color, Text emphasis, Hide border around pressable text Styling for the pressable text style

Edit button

Setting What it does
Show an Edit button On by default. Turn it off to show only the Add-on or Subscribe button.
Button text, Button icon Defaults to “Edit”, without an icon
Quantity label, Remove label Labels in the popover. The Subscribe popover uses the same quantity label.
Enable quantity changes Turn off to only allow variant and subscription changes
Show a subscribe checkbox in the popover Lets customers switch the item to a subscription. Subscribe checkbox label defaults to “Subscribe & save”.

Add-on button

Setting What it does
Show an Add-on button Turns the button on
Button text, Button icon Defaults to “Add-on”, without an icon
Popover button text Defaults to “Add”
Show the variant name when only one variant is available Shows it under the product’s name in the popover

Subscribe button

Setting What it does
Show a Subscribe button Turns the button on
Button text, Button icon Defaults to “Subscribe & save”, without an icon
Popover button text Defaults to “Subscribe”

At least one button has to be on to save the block.

Shows minus and plus buttons under each item. Minus at quantity 1 removes the item.

Hide add quantity button removes the plus button, so customers can only reduce quantities.

  • Editing an item, subscribing it or adding an add-on marks the item as changed by Checkout Buddy, like items added by a Product offers block. It then counts for conditions such as Line item added by Checkout Buddy, and for product discounts set to apply to Checkout components (upsells, cross-sells, etc.), but not for ones set to Product offers (items they add). The simple editor doesn’t do this.
  • If the checkout doesn’t allow changing items, for example some B2B and draft order checkouts, the editor doesn’t show.
  • Changing to a variant that doesn’t support the item’s subscription shows an error and keeps the old variant.
  • Translations entered for the Cart line editor are only used in the Cart line item app block. In the Checkout Buddy (v1) app block, write its labels in your checkout’s main language.