--- title: "Setting Up Checkout Line Item Editing" description: "Let customers adjust eligible checkout items before payment." url: https://docs.orderediting.com/en/articles/15311167-setting-up-checkout-line-item-editing collection: "App Blocks" updated: 2026-11-02 language: en --- # Setting Up Checkout Line Item Editing Let customers adjust eligible checkout items before payment. # 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 1. In Shopify admin, open **Settings > Checkout**. 2. Select **Customize** for the published checkout profile. 3. Confirm you are editing the **Checkout** page. 4. Select **Add app block** in the cart-line area supported by Shopify. 5. Add **Edit Line Item** from Order Editing. 6. Select the block and review its settings. 7. 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 1. In the same **Checkout** page, select **Add app block** in the Order Summary cart-line area. 2. Add **Remove Upsell Product** from Order Editing. 3. 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 1. Add two ordinary physical products to the cart and continue to Shopify Plus checkout. 2. Use **Edit item** on one line to change its quantity. 3. Change to another available variant. 4. Replace it with another eligible product. 5. Select **Remove item**, then confirm the line leaves the cart and totals recalculate. 6. Select **Cancel** on another line and confirm the cart is unchanged. 7. Add a product through a Product List Upsell. 8. Use the removal action supplied by Remove Upsell Product. 9. 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. ## Related - [Shipping Address Edits](https://docs.orderediting.com/en/articles/14154099-shipping-address-edits.md) - [Change Products](https://docs.orderediting.com/en/articles/14154149-change-products.md) - [Quantity Edits](https://docs.orderediting.com/en/articles/14154273-quantity-edits.md) - [Product Search](https://docs.orderediting.com/en/articles/14154310-product-search.md) - [Shipping Methods](https://docs.orderediting.com/en/articles/14154407-shipping-methods.md)