What is Magento Multi-Source Inventory (MSI)?
Short answer Magento Inventory Management, often called Multi-Source Inventory or MSI, separates inventory locations from the stock available to website sales channels. Sources hold quantities, stocks aggregate availability and reservations record order-related holds and compensations. It supports single-source as well as multi-source operation.
The model is useful even with one location. Understand website mapping, salable quantity and fulfillment before changing the number of sources.
- Sources record inventory locations 01
- Stocks connect sources to website sales channels 02
- Salable quantity accounts for stock and reservations 03
- Source selection recommends fulfillment deductions 04
- Model Sources, stocks and reservations
- Availability Salable quantity is stock-scoped
- Scope Single-source and multi-source operation
Watch for this Confusing on-hand inventory with salable availability
The four inventory responsibilities
Sources, stocks, salable quantities and source selection serve different roles. A positive warehouse quantity alone does not describe the complete order path.
-
Sources record inventory locations
A source represents a location where inventory is managed or services are available. On-hand quantities belong to a product at a source. Single-source merchants use the Default Source; multiple warehouses are not required to use Inventory Management.
-
Stocks connect sources to website sales channels
A stock aggregates the assigned sources for its websites. A website maps to one stock, while a stock can serve several websites. Decide the mapping explicitly; an extra store view or B2B customer group does not by itself create a separate stock.
-
Salable quantity accounts for stock and reservations
On-hand quantity and salable quantity answer different questions. Standard reservations record order-related holds and later compensations at the SKU/stock level. Thresholds, backorders and product settings also matter. Adding a product to a cart alone is not the standard order-placement reservation.
-
Source selection recommends fulfillment deductions
The Source Selection Algorithm recommends sources for fulfillment; it is not a guaranteed cheapest-carrier or fastest-delivery service. Shipment, cancellation and other supported order actions adjust quantities and reservations. Virtual/downloadable products follow their documented invoice-time path rather than physical shipping selection.
Where the inventory model applies
These scenarios explain the inventory model and its boundaries. They do not prescribe a live inventory reconfiguration.
-
A single fulfillment location
The Default Source and Default Stock support a single-source operation. Treat moving to multiple sources as a business and data-model change, not an obligatory extra step for every store.
-
Several warehouses hold the same SKU
Track each location separately and assign the appropriate sources to the website stock. Availability is not simply the quantity shown for one warehouse.
-
Websites sell from different source pools
Use deliberate stock-to-website mapping where different websites have different available inventory. Coordinate shared sources and replenishment so the business understands which channels draw on the same physical quantities.
-
Pickup or distributed fulfillment is required
Inventory locations can support pickup or distributed shipping workflows, but carrier, checkout and pickup features need their own configuration. MSI alone does not promise a complete warehouse-management or routing system.
-
An ERP updates stock or fulfills orders
Define who owns source quantities and how order, shipment and cancellation events are synchronized. An import succeeding does not prove reservations, pending orders or source assignments remain consistent.
Three inventory assumptions to check
Check the SKU, website stock and order history before changing quantities, source assignments or processing settings.
-
Confusing on-hand inventory with salable availability
Compare the child or simple SKU, website stock, source status, reservations and settings. A positive source quantity alone does not establish that checkout should accept an order.
-
Editing source assignments around pending orders without a plan
Unassigning sources can remove quantity data and affect outstanding order handling. Review pending work, integration ownership and recovery before restructuring. Deleting reservation rows is not a safe general correction.
-
Assuming a consumer definition proves a running process
Queue definitions, live worker processes and successful message handling are different checks. Monitor the relevant inventory processing and indexer behavior through the project operations process. More workers or a larger broker do not automatically correct inconsistent business data.
Six questions about Inventory Management
Is MSI on by default in Magento 2?
Adobe documents Inventory Management as installed with Magento Open Source and Adobe Commerce, with features enabled by default. A particular upgraded or customized installation still needs inspection. Single-source operation uses the Default Source and Default Stock; adopting several warehouses is a separate configuration decision.
MSI vs the old single-stock model: what’s the performance cost?
There is no universal percentage cost. The number of sources and stocks, SKU volume, indexing, order activity and integration behavior affect the workload. Measure representative catalog, checkout and fulfillment operations. Disabling modules or deleting reservations to chase a benchmark can break outstanding orders.
Does MSI work with Hyvä Themes?
Inventory Management is backend inventory logic, while the storefront determines how availability and pickup choices are presented. Verify the installed Hyvä theme, checkout and inventory-related extensions through the intended order flows. A theme label alone is not compatibility proof for every integration.
Can I write a custom Source Selection Algorithm?
Yes. The Inventory Source Selection API exposes an extension interface for selection algorithms. Define the inventory request, eligible sources and business criteria, then validate the recommendations and fulfillment behavior. A custom recommendation does not by itself configure carrier rates or guarantee a delivery outcome.
Does MSI play nicely with B2B + customer-segment pricing?
Pricing, catalog permissions and company workflows are separate from source and stock availability. Validate their combined behavior for the intended website and buyer. Standard stock mapping is website-based; do not assume that a customer segment or shared catalog automatically owns an independent inventory pool.
Adobe Commerce vs Open Source: any MSI feature difference?
The core Inventory Management model is available in both. Adobe Commerce and installed extensions can add separate B2B, storefront or operational features. Check the exact release and packages for the requirement rather than assuming every capability or integration is identical across editions.
Need MSI configured for a real multi-warehouse build?
Describe the source locations, website mapping, pending-order process and integration owners. Those inputs establish the scope of an inventory change and its acceptance checks.