Before you begin
- Shopify Plus is required to add checkout app blocks.
- Confirm you can edit and save the published Shopify checkout profile.
- Decide whether customers may edit draft-order checkouts.
- Review product, tag, bundle, discount, market, and inventory restrictions.
Checkout Line Item Editing is not an upsell strategy. It is a pair of Shopify checkout extensions that lets customers edit eligible cart lines and optionally remove products accepted from an Order Editing checkout upsell.
What customers can do
With Edit Line Item, eligible customers can open Edit item to change quantity, select another variant, replace the product, or select Remove item. Cancel closes the editor without changing the cart.
With Remove Upsell Product, customers can remove an eligible product that was added through an Order Editing checkout upsell.
Shopify recalculates the checkout after the cart line changes.
Free and digital lines open a remove-only editor. Paid physical lines get the full editor when Shopify allows the line to update.
Checkout must keep at least one item. Remove item is unavailable when the line is the only product in the cart.
Install Edit Line Item
- In Shopify admin, open Settings > Checkout.
- Select Customize for the published checkout profile.
- Confirm you are editing the Checkout page.
- Select Add app block in the cart-line area supported by Shopify.
- Add Edit Line Item from Order Editing.
- Select the block and review its settings.
- Select Save.
Configure Edit Line Item
Setting | What it controls |
|---|---|
Draft editing | Allows eligible draft-order checkouts to use the editor. |
Edit cart | Appears in the block settings. The current extension does not read this control. Shopify's line-update instructions still determine whether a paid physical line can be edited. |
Disable free items | Legacy unused setting. Free items still show Edit item with remove-only actions. |
Disable digital items | Legacy unused setting. Digital items still show Edit item with remove-only actions. |
Hidden Product Tags | Excludes products with matching tags from the replacement experience. |
Products Restrict Editing | Excludes products with matching titles from the replacement experience. |
Reviews Style | Controls supported review presentation in the edit modal. |
Discounts Badge | Controls supported discount-badge presentation. |
Developer logging, feature flags, and endpoint controls are for testing or support-led investigation. Do not change them as routine merchant configuration.
Languages
Edit Line Item and Remove Upsell Product show their labels in the checkout's language, using translations that ship with each block, so the labels appear without waiting for anything to load. Both blocks follow the checkout's language in Shopify's checkout editor too, so neither has a Language setting. To check a translation, open a checkout in that language.
Install Remove Upsell Product
- In the same Checkout page, select Add app block in the Order Summary cart-line area.
- Add Remove Upsell Product from Order Editing.
- Select Save.
The removal action appears only for supported products added through an Order Editing checkout upsell. It is not a general remove link for every product the customer put in the cart.
Understand eligibility limits
Not every cart line can be edited in every way. Eligibility can be affected by:
- the block settings above
- product and market availability
- inventory
- custom discounts or allocations
- bundle structure
- free or digital product status
- product-title or product-tag restrictions
- Shopify checkout behaviour
- whether the line is the only item in the cart
Test bundle and heavily discounted items with the apps that created them. Protecting the source data is more important than exposing every edit action.
Check it in checkout
- Add two ordinary physical products to the cart and continue to Shopify Plus checkout.
- Use Edit item on one line to change its quantity.
- Change to another available variant.
- Replace it with another eligible product.
- Select Remove item, then confirm the line leaves the cart and totals recalculate.
- Select Cancel on another line and confirm the cart is unchanged.
- Add a product through a Product List Upsell.
- Use the removal action supplied by Remove Upsell Product.
- Repeat with a free item, digital item, restricted product, bundle, and draft checkout according to your settings.
You do not need to place an order. These extensions change checkout lines before payment, so the checkout itself shows the line updates and recalculated totals.
Troubleshooting
Edit item does not appear
Confirm Edit Line Item is installed and saved, and that Shopify reports the line as eligible for an update. Free and digital lines still show Edit item when Shopify allows removal. Paid physical lines need Shopify's line-update permission, unless draft editing covers that checkout.
A customer can edit only part of the item
Review free-item, digital-item, tag, title, bundle, discount, inventory, and market restrictions. A protected line may offer fewer actions. Free and digital lines are remove-only.
A replacement fails
Confirm the replacement product and variant are active, available in the customer's market, and in stock. Then review discounts and bundle constraints.
Remove item is missing or disabled
Confirm the cart has more than one line. Checkout cannot be empty. For upsell-only removal under the line, confirm Remove Upsell Product is installed and the line was added through a supported Order Editing checkout upsell.
Edit Line Item or Remove Upsell Product labels are in the wrong language
Both blocks use the checkout's language. Confirm the language is published in your Shopify store and active in the customer's market. If a label still shows in English, the block has no translation for that language yet.
