Source
Catalogue & checkout — found from sitemap — Vendure
Checked for Vendure on 3 Nov 2026
- Page
- https://docs.vendure.io/current/framework/core-concepts/cart
- Checked
- 3 Nov 2026, 15:42 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:15da2420ed52255247e3d5d900772de9d385a976577af613e40c64e8ae0e679b
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
Cart unified with order Report an error
“Vendure does not have a separate "Cart" entity. Instead, a cart is simply an Order in the AddingItems state.”
-
Active order limit per session Report an error
“Every customer session (whether authenticated or guest) can have at most one active order — the order in the AddingItems state.”
-
Active order strategy Report an error
“The active order resolution logic is handled by the ActiveOrderStrategy. The default strategy uses the session to track the active order, but this can be customized for scenarios like named wishlists or saved carts.”
-
Cart mutations Report an error
“When a customer calls mutations like addItemToOrder, adjustOrderLine, or removeOrderLine, Vendure automatically finds (or creates) the active order for the current session. There is no need to pass an order ID; the active order is resolved from the session context.”
-
Order line fields Report an error
“quantity — How many units of this variant are in the cart. unitPrice / unitPriceWithTax — The per-unit price as determined by the pricing pipeline. linePrice / linePriceWithTax — The total for this line (unit price multiplied by quantity, with adjustments applied). adjustments — Any discounts from promotions that apply to this line.”
-
Duplicate variant behavior Report an error
“If a customer adds the same variant twice, Vendure increments the quantity on the existing OrderLine rather than creating a duplicate.”
-
Order interceptors Report an error
“Order Interceptors allow custom validation or side-effects to be executed when items are added to or modified in the cart. For example, you could use an interceptor to enforce a maximum quantity per product, validate that items are still in stock, or check business rules before allowing the cart to be modified.”
-
Guest cart behavior Report an error
“Guest carts are tied to an anonymous session. If the session expires, the cart is no longer accessible.”
-
Authenticated cart persistence Report an error
“Authenticated carts are associated with a Customer account. The customer can log out and return later to find their cart intact.”
-
Cart merge on login Report an error
“When a guest customer logs in, Vendure can merge their anonymous cart with any existing cart on their account, ensuring no items are lost during the transition.”
-
Order custom fields during cart Report an error
“Since the cart is an Order entity, you can use custom fields to store additional data during the cart phase. For example, gift message text, delivery instructions, or a purchase order number can all be captured as custom fields on the order while the customer is still shopping.”
-
Order state flow Report an error
“AddingItems — The cart state. Items can be freely added, removed, or adjusted. ArrangingPayment — The customer has provided shipping details and is ready to pay. Cart modifications are no longer allowed. PaymentSettled / PaymentAuthorized — Payment has been processed.”
-
Checkout transition validation Report an error
“The transition from AddingItems to ArrangingPayment enforces validation — the order must have at least one item, a shipping method must be set, and any other custom validation defined by order process plugins must pass.”
Scores citing this record
- The B2B Seller Catalogue & checkout
- The Data Protection Officer Catalogue & checkout
- The Developer Catalogue & checkout
- The Merchant Catalogue & checkout
- The Merchant Tax & German legal correctness
- The Operations Lead Catalogue & checkout
- The Operations Lead Tax & German legal correctness
- The Skeptic Catalogue & checkout