Vendure does not have a separate "Cart" entity. Instead, a cart is simply an Order in the AddingItems state. This unified model means that the same entity, the same database table, and the same state machine govern an order from the moment a customer adds their first item all the way through to fulfillment.
Every customer session (whether authenticated or guest) can have at most one active order — the order in the AddingItems state. This is the order that the Shop API's cart-related mutations operate on.
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.
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.
Each item in the cart is represented by an OrderLine. An OrderLine links a specific to the order, along with:
If a customer adds the same variant twice, Vendure increments the quantity on the existing OrderLine rather than creating a duplicate.
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.
Interceptors are registered at the server level and run during cart-modifying operations, giving you a clean hook to inject custom logic without overriding the built-in mutations.
Customer account. The customer can log out and return later to find their cart intact.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.
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.
Once the customer is ready to check out, the order transitions from AddingItems through the order state machine. The typical flow is:
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.
Architecture reviews, custom plugin work, migrations, ongoing support. Get a hand from the team that builds Vendure.
Talk to the team