Skip to main content

Order summary

The order summary area displays cart line items, applied discounts, and cost totals on the checkout page. Extensions in this area help buyers make informed purchase decisions by surfacing information like product details, promotions, and savings alongside their order. Learn more about building checkout extensions.

Extensions at the reductions targets render alongside the native discount form, not in place of it. Your extension appears before or after the existing discount elements.

The cart line item target doesn't render for custom line items belonging to draft order invoices.

  • Per-item warranty and protection offers: Display product protection plans or extended warranties on individual items, letting buyers add coverage before completing their purchase.
  • Product customization display: Show personalized details like engraving text, gift messages, or configuration options beneath each item in the order summary.
  • Cross-sell and product recommendations: Suggest related products or frequently bought together items after the cart line list, allowing buyers to add them directly.
  • Custom discount interfaces: Build branded discount entry fields or loyalty point redemption controls before or after the native discount form.
  • Gift card balance and application: Let buyers check gift card balances and apply them to their order alongside or separate from the standard discount inputs.
  • Order savings breakdowns: Display detailed summaries of all applied discounts, automatic savings, and promotional offers after the discount area.

Use these static extension targets to extend the order summary line items area during checkout. These targets support the full checkout component set, including form fields, banners, images, and interactive elements. The examples demonstrate using API methods for cart mutations and API properties for reading checkout state.

purchase.checkout.cart-line-item.render-after

Renders on every line item in the order summary, inside the details under the line item properties element. This target is instantiated once for each item in the cart. To selectively show content for specific items, inspect the cart line data from target and return null for items where your extension doesn't apply.

This target receives additional cart line item properties that provide the specific cart line through the target property with access to merchandise details, quantity, cost, attributes, discount allocations, and bundle line components.

Extensions at this target have write access through API methods for cart lines, discount codes, gift cards, notes, attributes, metafields, and shipping address changes. Extensions also have read access through API properties to checkout state, including shop information, buyer identity, cost breakdowns, and cart lines.

Support
Components (55)
APIs (24)

purchase.checkout.cart-line-list.render-after

Renders once after all line items in the order summary. This target appears once per checkout, unlike the cart line item target, which is instantiated for each item.

Extensions at this target have write access through API methods for cart lines, discount codes, gift cards, notes, attributes, metafields, and shipping address changes. Extensions also have read access through API properties to checkout state, including shop information, buyer identity, cost breakdowns, and cart lines.

Support
Components (55)
APIs (24)

Use these static extension targets to extend the order summary reductions area, where discount codes and gift cards are applied. These targets support the full checkout component set, including form fields, banners, images, and interactive elements. The examples demonstrate using API methods for applying discount codes and gift cards.

purchase.checkout.reductions.render-before

Renders in the order summary before the discount form element.

Extensions at this target have write access through API methods for cart lines, discount codes, gift cards, notes, attributes, metafields, and shipping address changes. Extensions also have read access through API properties to checkout state, including shop information, buyer identity, cost breakdowns, and cart lines.

Support
Components (55)
APIs (24)

purchase.checkout.reductions.render-after

Renders in the order summary after the discount form and discount tag elements.

Extensions at this target have write access through API methods for cart lines, discount codes, gift cards, notes, attributes, metafields, and shipping address changes. Extensions also have read access through API properties to checkout state, including shop information, buyer identity, cost breakdowns, and cart lines.

Support
Components (55)
APIs (24)

  • Reserve space for dynamic content: The order summary is visible throughout checkout. If you load data asynchronously, use a skeleton paragraph or spinner to hold space while content loads.
  • Keep per-item extensions lightweight: The cart line item target runs once for each item in the cart. Avoid heavy network calls for each instance and consider caching data using the Storage API to reduce repeated requests.
  • Use the cart line target property directly: In the cart line item target, read shopify.target.value for the specific cart line rather than searching through shopify.lines. The cart line item properties give you direct access to the attached line item.
  • Re-read cart line IDs after mutations: Cart line IDs can change after any cart modification through applyCartLinesChange. Always re-read the ID from the API before mutating a specific line.

Was this page helpful?