Cart and checkout: the parts, in plain words

51 parts and 16 phrases. Apps in this area include Shopify Checkout, Bolt, Fast, Slide Cart, UpCart, Stripe Checkout.

The cartcheckout.cartShowWhat the cart holds and where the shopper sees it.

Cart contentscheckout.cart.contentsShowThe lines in a cart and the rules on each line.

How to extend

EventMany side by sideevent.cart.item_added event.cart.item_updated event.cart.item_removed event.cart.mergedA plugin subscribes to cart changes to update its own records, such as a wishlist or an analytics tool.
Core onlyLine prices and quantities stay in core because checkout charges exactly what the cart lines hold.

Part	Litestore today	How to extend
Cart line`checkout.cart.contents.line_item`A cart line holds one product variant and its quantity, and the cart total is the sum of its lines.	Core`modules/checkout/cart-lines.ts`	Event · manyCore only
Add-on line`checkout.cart.contents.add_on_line`An add-on line is tied to a parent line, such as installation for one product, and is removed when the parent line is removed.	Core`modules/checkout/cart-lines.ts`	Event · manyCore only
Quantity limit`checkout.cart.contents.quantity_limit`A quantity limit caps how many units of a variant fit in the cart, based on the stock that is free to sell.	Core`modules/checkout/storefront/purchase-eligibility.ts`	Event · manyCore only
Price snapshot`checkout.cart.contents.price_snapshot`A price snapshot stores each line's unit price when checkout starts, so the charge matches the price the shopper saw.	Core`modules/checkout/price-resolution.ts`	Event · manyCore only
Line attribute`checkout.cart.contents.line_attribute`A line attribute is a custom value stored on one cart line, such as engraving text or a chosen date.	Plugin	Event · manyCore only
Cart note`checkout.cart.contents.cart_note`A cart note is free text the shopper writes on the cart that is copied onto the order.	Plugin	Event · manyCore only
Guest cart`checkout.cart.contents.guest_cart`A guest cart is tied to a browser cookie, so a shopper fills a cart without an account.	Core`modules/checkout/cart-cookie.ts`	Event · manyCore only
Cart merge on sign-in`checkout.cart.contents.cart_merge`Cart merge joins the guest cart with the customer's saved cart when the shopper signs in.	Core`modules/checkout/resolve-cart.ts`	Event · manyCore only
Cart handoff link`checkout.cart.contents.cart_handoff_link`A cart handoff link opens a cart that was built elsewhere, such as by an AI shopping assistant, in the shopper's browser for checkout.	Core`app/(web)/cart/claim/route.ts`	Event · manyCore only

Where the cart showscheckout.cart.surfaceShowThe page or panel that shows the cart and the extras around it.

How to extend

SlotMany side by sidestorefront.slot.cart.below_items storefront.slot.cart.above_checkout_buttonA plugin renders a banner, an offer or a progress bar in a named place on the cart.

Part	Litestore today	How to extend
Cart page`checkout.cart.surface.cart_page`A cart page is a full page that lists the cart lines, the totals and the button to check out.	Core`app/(web)/cart/page.tsx`	Slot · many
Side panel cart`checkout.cart.surface.side_panel`A cart drawer is a panel that slides in from the side of any page and shows the cart without leaving the page.	Plugin	Slot · many
Progress to free shipping`checkout.cart.surface.free_shipping_progress`A free-shipping progress bar shows how much more the shopper has to spend to reach the free-shipping threshold.	Core`modules/checkout/storefront/free-shipping-bar.tsx`	Slot · many
Progress to spend goals`checkout.cart.surface.spend_goal_progress`A reward tiers bar shows several spend goals in a row, each unlocking a gift or a discount.	Plugin	Slot · many
Discount code field`checkout.cart.surface.discount_field`A discount code field takes a code on the cart and shows the discount in the totals.	Core`modules/checkout/cart-discounts.ts`	Slot · many
Points redemption`checkout.cart.surface.points_redemption`Points redemption spends a customer's loyalty points as money off the cart.	Core`app/api/cart/loyalty/route.ts`	Slot · many

Checkout stepscheckout.flowShowThe steps between the cart and a paid order, in the order the shopper meets them.

Contact and accountcheckout.flow.contactShowWho is buying and whether they buy with an account.

How to extend

EventMany side by sideevent.checkout.started event.customer.createdA plugin subscribes to started checkouts and new customers, for example to add the email to a list.

Part	Litestore today	How to extend
Email capture`checkout.flow.contact.email_capture`Email capture stores the shopper's email at the start of checkout, so the order and any follow-up email have an address.	Core`platform/stripe-payment-provider.ts`	Event · many
Guest checkout`checkout.flow.contact.guest_checkout`Guest checkout completes an order with only an email and an address, without creating an account.	Core`modules/checkout/execute-checkout.ts`	Event · many
Signed-in checkout`checkout.flow.contact.signed_in_checkout`Signed-in checkout links the order to the customer's account and fills in their saved details.	Core`modules/checkout/storefront/checkout-extras.ts`	Event · many
Account after order`checkout.flow.contact.account_after_order`Account after order offers a guest buyer an account on the thank-you page and attaches the order to it.	Core`modules/checkout/storefront/save-order-account.tsx`	Event · many
Blocked buyer check`checkout.flow.contact.buyer_gate`A blocked buyer check rejects a checkout from an account the store has restricted or banned.	Core`modules/customers/stage.ts`	Event · many

Addresscheckout.flow.addressShowWhere the order goes.

How to extend

ProviderOne per storeaddress autocomplete providerAn address lookup service fills the address fields from a few typed characters.

Part	Litestore today	How to extend
Address form`checkout.flow.address.address_form`An address form collects name, street, city, postcode, country and phone for delivery.	Core`modules/checkout/storefront/shipping-view.tsx`	Provider · one
Saved address`checkout.flow.address.saved_address`A saved address is picked from the customer's address book instead of being typed again.	Core`modules/checkout/storefront/checkout-extras.ts`	Provider · one
Allowed countries`checkout.flow.address.allowed_countries`Allowed countries limits the address to countries that have an active shipping rate.	Core`modules/checkout/shipping-countries.ts`	Provider · one
Address autocomplete`checkout.flow.address.autocomplete`Address autocomplete suggests full addresses from a lookup service as the shopper types and fills the fields.	Plugin	Provider · one
Address validation`checkout.flow.address.validation`Address validation checks the address against a postal database and flags one that cannot be delivered to.	Plugin	Provider · one

Delivery choicecheckout.flow.deliveryShowHow the order reaches the shopper and what that costs.

How to extend

ProviderMany side by sideshipping rate providerA carrier or rate service adds delivery options and prices to the list the shopper picks from.

Part	Litestore today	How to extend
Shipping method choice`checkout.flow.delivery.shipping_method`A shipping method choice lists the rates the cart qualifies for and stores the one the shopper picks.	Core`modules/checkout/storefront/shipping-view.tsx`	Provider · many
Pickup point choice`checkout.flow.delivery.pickup_point`A pickup point choice stores the store or locker where the shopper collects the order.	Core`modules/checkout/storefront/shipping-view.tsx`	Provider · many
Delivery estimate`checkout.flow.delivery.delivery_estimate`A delivery estimate shows the earliest and latest expected delivery dates for each rate.	Core`modules/checkout/checkout-estimates.ts`	Provider · many
Tax estimate`checkout.flow.delivery.tax_estimate`A tax estimate shows the tax before payment, calculated by the same rules as the charge.	Core`modules/checkout/checkout-estimates.ts`	Provider · many
Delivery date pick`checkout.flow.delivery.delivery_date`A delivery date pick lets the shopper choose the day the order arrives from a calendar of open dates.	Plugin	Provider · many

Review and paymentcheckout.flow.paymentShowThe last look at the order, the payment step and the holds placed while the shopper pays.

How to extend

SlotMany side by sidecheckout.slot.payment.below_methodsA plugin renders a notice or a trust badge near the payment step.
ProviderOne per storepayment providerOne payment provider takes the payment for a store; Litestore uses Stripe.

Part	Litestore today	How to extend
Order review`checkout.flow.payment.order_review`An order review shows lines, discount, delivery, tax and total together before the shopper pays.	Core`modules/checkout/storefront/checkout-review.tsx`	Slot · manyProvider · one
Hosted payment page`checkout.flow.payment.hosted_payment_page`A hosted payment page is run by the payment provider, which collects the card or wallet and sends the shopper back to the store.	Core`platform/stripe-payment-provider.ts`	Slot · manyProvider · one
On-site payment form`checkout.flow.payment.on_site_payment_form`An on-site payment form collects card details inside the store's own checkout page instead of on the provider's page.	Plugin	Slot · manyProvider · one
Wallet payment shortcut`checkout.flow.payment.wallet_shortcut`Express checkout buttons put wallet buttons such as Apple Pay or Shop Pay on the product page or cart, and the wallet supplies the address and payment in one step.	Plugin	Slot · manyProvider · one
Double-charge guard`checkout.flow.payment.double_charge_guard`A double-charge guard returns the same payment session when a checkout is submitted twice, so one cart is charged once.	Core`platform/stripe-payment-provider.ts`	Slot · manyProvider · one
Stock reservation`checkout.flow.payment.stock_reservation`A stock reservation holds the cart's units for a set time while the shopper pays, so the stock is not sold twice.	Core`modules/checkout/stock-reservation.ts`	Slot · manyProvider · one
Reservation release`checkout.flow.payment.reservation_release`A reservation release returns held units to stock when a checkout is not paid within the hold time.	Core`jobs/cron.stock-cleanup.ts`	Slot · manyProvider · one
Coupon reservation`checkout.flow.payment.coupon_reservation`A coupon reservation holds one use of a limited code while the shopper pays, so the limit is not exceeded.	Core`modules/checkout/coupon-reservation.ts`	Slot · manyProvider · one

Checkout extrascheckout.flow.extrasShowOptional fields and choices added to checkout.

How to extend

SlotMany side by sidecheckout.slot.delivery.below_methodsA plugin renders its own fields in checkout and stores the answers on the order.

Part	Litestore today	How to extend
Order note`checkout.flow.extras.order_note`An order note is free text the shopper writes at checkout, such as delivery instructions, that is stored on the order.	Plugin	Slot · many
Gift message`checkout.flow.extras.gift_message`A gift message is a short note to the recipient that is stored on the order and printed on the packing slip.	Plugin	Slot · many
Gift wrap`checkout.flow.extras.gift_wrap`Gift wrap is a paid option added at checkout that marks the order for wrapping.	Plugin	Slot · many
Custom checkout field`checkout.flow.extras.custom_field`A custom checkout field asks an extra question, such as a company name or how the shopper heard of the store, and stores the answer on the order.	Plugin	Slot · many
Terms checkbox`checkout.flow.extras.terms_checkbox`A terms checkbox must be ticked before payment and records that the shopper accepted the store's terms.	Plugin	Slot · many

After checkoutcheckout.afterShowWhat happens once a checkout is paid, or once it is started and left.

Unpaid checkoutscheckout.after.unpaidShowCheckouts that were started and not paid, and the follow-up on them.

How to extend

EventMany side by sideevent.cart.abandoned event.cart.recoveredA plugin subscribes to abandoned carts to send its own message, such as an SMS.
Assistant toolMany side by sidegetAbandonedCartsgetCartRecoveryThe assistant reads abandoned carts and recovery results with these tools.

Part	Litestore today	How to extend
Unpaid checkout marker`checkout.after.unpaid.marked`Abandoned checkout capture marks a cart as abandoned when checkout was started and not paid within a set time.	Core`modules/checkout/abandonment.ts`	Event · manyAssistant tool · many
Cart reminder email`checkout.after.unpaid.reminder_email`A recovery email reminds the shopper of the cart and links back to it, in a series of timed sends.	Core`modules/email/automations.ts`	Event · manyAssistant tool · many
Reminder discount code`checkout.after.unpaid.reminder_code`A recovery coupon is a single-use code added to a later recovery email.	Core`modules/email/automations.ts`	Event · manyAssistant tool · many
Unpaid cart report`checkout.after.unpaid.report`An abandoned cart report lists abandoned carts with their value and whether each was later recovered.	Core`modules/checkout/abandoned-cart-reports.ts`	Event · manyAssistant tool · many

Order confirmationcheckout.after.confirmationShowWhat the shopper and the store get once payment succeeds.

How to extend

EventMany side by sideevent.order.created event.order.paidA plugin subscribes to paid orders to start its own work, such as sending to a fulfilment service.
SlotMany side by sidecheckout.slot.confirmation.main email.slot.order_confirmation.below_itemsA plugin renders content on the thank-you page or in the confirmation email.

Part	Litestore today	How to extend
Order number`checkout.after.confirmation.order_number`An order number is a short readable id given to each order for the shopper and the store to quote.	Core`modules/checkout/order-number.ts`	Event · manySlot · many
Order confirmation page`checkout.after.confirmation.confirmation_page`A thank-you page shows the order summary after payment and links to the order status.	Core`app/(web)/cart/success/page.tsx`	Event · manySlot · many
Confirmation email`checkout.after.confirmation.confirmation_email`A confirmation email sends the order lines, totals and address to the buyer once the order is paid.	Core`modules/email/templates/order-confirmation.tsx`	Event · manySlot · many
Purchase tracking`checkout.after.confirmation.purchase_tracking`Purchase tracking sends the order value and items to analytics and ad pixels once the order is paid.	Core`modules/checkout/storefront/purchase-tracking.tsx`	Event · manySlot · many

Phrase	Made of
express checkout	checkout.flow.payment.wallet_shortcut The wallet supplies address and payment, so the address and payment steps collapse into one.
accelerated checkout	checkout.flow.payment.wallet_shortcut
cart drawer	checkout.cart.surface.side_panel
slide cart	checkout.cart.surface.side_panel
free shipping bar	checkout.cart.surface.free_shipping_progress
cart progress bar	checkout.cart.surface.spend_goal_progress
guest checkout	checkout.flow.contact.email_capture checkout.flow.contact.guest_checkout
order notes	checkout.flow.extras.order_note
gift message	checkout.flow.extras.gift_message
address autocomplete	checkout.flow.address.autocomplete
inventory reservation	checkout.flow.payment.stock_reservation checkout.flow.payment.reservation_release
abandoned checkout recovery	checkout.after.unpaid.marked checkout.after.unpaid.reminder_email checkout.after.unpaid.reminder_code
thank you page	checkout.after.confirmation.confirmation_page
delivery date picker	checkout.flow.delivery.delivery_date
custom checkout fields	checkout.flow.extras.custom_field
line item properties	checkout.cart.contents.line_attribute

Cart and checkout

What the phrases mean

Phrases left out

Sources