Cart Totals

This family renders cart total fields from cartTotals and live Store API cart totals.

Components

Component key	Field
OmeWooCartTotalsList	Container for total atoms on cart pages.
OmeWooTotalsSubtotal	total_items
OmeWooTotalsDiscount	total_discount
OmeWooTotalsShipping	total_shipping
OmeWooTotalsTax	total_tax
OmeWooTotalsTotal	total_price

The same total atoms are also used in OrderSummaryTotalsList on checkout pages.

Authoring Structure

CartTotalsList
  TotalsSubtotal
  TotalsDiscount
  TotalsShipping
  TotalsTax
  TotalsTotal

List Props

Prop	Meaning
structure.root_tag	Wrapper element for the list.
styling.list_class	Class prop for the list wrapper.

Atom Props

All total atoms share props from CartTotalProperties.

Prop	Meaning
content.show_label	Renders label and value in a wrapper when true.
content.label	Label text when labels are enabled.
content.label_position	prefix or suffix.
structure.html_tag	Wrapper tag when label is enabled.
styling.value_class	Class prop for the value span.
styling.class	Wrapper class when label is enabled.
styling.label_class	Label class when label is enabled.

Runtime Behavior

cart-totals.ts formats minor-unit Store API totals using currency metadata from the response. It updates every matching data-ome-woo-cart-total-field, except fields inside an order summary when the cart page binding is running. OrderSummary owns its own summary total rendering.

Scenario Coverage

Scenario	Covered behavior
cart_totals_taxed_cart	Tax, subtotal, and final total render for a seeded taxable cart.
cart_totals_and_empty_slot	Empty cart keeps totals at zero.
cart_page_update_and_remove	Quantity and removal refresh totals.
shipping_selector	Shipping rate selection updates shipping and total.
lifecycle pricing	Native Woo pricing hooks change rendered totals.