Magento_Quote

Shopping cart functionality, quote lifecycle, and the transition from cart to order. Cart management, totals calculation through collectors, address handling, payment/shipping method selection, and quote-to-order conversion.

Magento\Quote 2.4.7+ 9 Documents PHP 8.2+

Core Documentation

Foundational knowledge for working with the Quote module.

Core

Overview

  • Cart management (add/update/remove items)
  • Quote lifecycle states (active, merged, converted, expired)
  • Totals collectors pipeline
  • Guest cart handling
  • Multi-address checkout
  • Quote-to-order conversion
Read overview
Core

Architecture

  • Quote/QuoteItem entity models
  • Totals collector chain (subtotal, shipping, tax, discount, grand_total)
  • CartRepositoryInterface
  • Address model hierarchy
  • quote_id_mask for guest APIs
Read architecture
Core

Execution Flows

  • Add-to-cart pipeline with stock/price validation
  • Totals recalculation sequence
  • Cart merge on customer login
  • Shipping/payment method assignment
  • Quote submission to order creation
Read flows

Extension Points

Hooks, plugins, observers, and integration boundaries for extending quote behavior.

Extension

Plugins & Observers

  • Plugins on CartRepositoryInterface::save()
  • Plugins on CartManagementInterface::placeOrder()
  • Event: sales_quote_save_after
  • Event: sales_quote_item_qty_set_after
  • Event: checkout_cart_add_product_complete
  • Custom totals collector injection
Read plugins & observers
Extension

Integrations

  • Catalog — product data, pricing
  • Customer — customer quotes, address prefill
  • Sales — quote-to-order conversion
  • CatalogInventory — stock validation
  • REST/GraphQL cart APIs
  • Third-party shipping/tax calculator integration
Read integrations

Quality & Maintenance

Anti-patterns, known issues, version changes, and performance guidance.

Quality

Anti-Patterns

  • Direct quote table manipulation
  • Bypassing CartRepositoryInterface
  • Manual totals calculation
  • Incorrect guest cart mask handling
  • Not clearing quote after order placement
Read anti-patterns
Quality

Known Issues

  • Cart merge losing custom options
  • Totals collector ordering conflicts
  • Expired quote cleanup race conditions
  • Multi-currency quote conversion edge cases
Read known issues
Quality

Version Compatibility

  • CartRepositoryInterface method signature changes
  • Deprecated quote collection methods
  • Async cart operations introduced in 2.4.x
  • Address validation API changes
Read compatibility
Quality

Performance

  • Totals collection optimization
  • Quote item count queries
  • Session-based vs database cart storage
  • Cart page load optimization
  • Quote cleanup cron tuning
Read performance

Related Modules

Catalog

Product data, pricing, and attribute metadata consumed by Quote for cart items.

View module

Checkout

Orchestrates the multi-step UI flow that turns a quote into a placed order.

View module

Sales

Receives the converted quote as an order for lifecycle management and fulfillment.

View module

Customer

Provides authentication, saved addresses, and customer group context for quotes.

View module
Back to all modules