Skip to main content

Order Summary

OrderSummary renders checkout cart contents and totals. It is read-only by default and intentionally reuses cart item and total atoms.

Components

Component keyRole
OmeWooOrderSummarySummary shell backed by cart store.
OmeWooOrderSummaryTotalsListTotals list container for checkout summary totals.
Cart item atomsOptional product row atoms in product_atoms or full_atoms modes.
Total atomsOptional totals row atoms in full_atoms mode.

Content Modes

ModeMeaning
proppedThe component renders product rows and totals from its own props and internal structure.
product_atomsAuthors provide the products slot with cart item atoms; totals stay component-managed.
full_atomsAuthors provide both products and totals slots.

TestCheckoutDemo uses full_atoms so the checkout summary can style product rows and total rows with the same atom components used elsewhere.

Props

PropMeaning
content.modeSummary rendering mode.
content.include_attributesWhether product titles include attributes in propped mode.
content.variant_separatorSeparator for composed variant titles.
accessibility.aria_labelSummary region label.

The totals list uses the same structure.root_tag and list class pattern as CartTotalsList.

Runtime Behavior

order-summary.ts subscribes to the cart store and renders summary rows from current cart data. The main Woo runtime excludes order-summary total fields from the cart-page totals binder so the summary binding owns its own subtree.

When authors use atom modes, cart item atoms and totals atoms still read the summary cart data. The order summary is read-only unless authors deliberately place interactive atoms inside it.

Scenario Coverage

ScenarioCovered behavior
shipping_selectorOrder summary total changes after shipping selection.
checkout_successCheckout can render order summary beside a real checkout form.
Lifecycle pricing testNative Woo pricing hooks change totals rendered in cart and order summary.
TestCheckoutDemoFull-atoms mode composes cart item title, attributes, subtotal, and all total atoms.