Managing stock across multiple warehouses, storefronts, or fulfillment centers is one of the most operationally complex challenges in eCommerce. Without the right system, merchants end up overselling, shipping from the wrong location, or losing visibility into what’s actually available.
Magento 2 Multi Source Inventory (MSI) solves this directly. This guide covers how it works, how to configure it, what features matter most, and what to watch out for during implementation.
Summary
- MSI lets merchants manage inventory across unlimited physical locations from a single Magento admin panel.
- Core components include Sources, Stocks, and the Source Selection Algorithm.
- Setup involves configuring sources, mapping them to stocks, and assigning products to those sources.
- MSI works for both single-location and multi-location merchants.
- Third-party integrations, including POS systems and WMS platforms, are supported via API.
- Common mistakes during setup can be avoided with a clear understanding of how salable quantity is calculated.
What Is Magento 2 Multi Source Inventory?
The Problem MSI Was Built to Solve
Before MSI was introduced in Magento 2.3, every store operated with a single inventory source. If you had three warehouses, you had to manage them externally and sync manually—an error-prone and slow process.
Magento 2 Multi Source Inventory changed that by making multi-location inventory management a native feature. Merchants can now define multiple sources (warehouses, retail stores, drop-shippers) and map them to sales channels without relying on third-party extensions.
Core Components at a Glance
| Term | Definition |
| Source | A physical location where inventory is stored (warehouse, storefront, 3PL) |
| Stock | A virtual grouping of sources assigned to a sales channel (website) |
| Salable Quantity | Total available inventory across all assigned sources, minus reservations |
| Source Selection Algorithm (SSA) | Logic that determines which source fulfills each order |
Understanding these four terms makes every other part of the system easier to work with.
Key Features of Multi Source Inventory Magento 2
Source Management
Each source represents a real physical location. You can create unlimited sources, assign them GPS coordinates and contact info, and enable or disable them without losing historical data.
One important limitation: source codes cannot be edited after creation. Choose them carefully during initial setup.
Stock Management
Stocks are the bridge between your sources and your sales channels. Each Magento website can only be assigned to one stock, but a single stock can pull from multiple sources. This is what enables regional fulfillment strategies without building custom infrastructure.
Source Selection Algorithm
The SSA is what makes multi source inventory Magento 2 operationally intelligent. When an order is placed, the algorithm evaluates available inventory across all sources and recommends the best fulfillment location based on stock availability and shipping proximity.
Merchants can use the default Distance Priority algorithm or build a custom one via API. For most mid-market operations, the default SSA is sufficient.
Salable Quantity Calculation
This is where most merchants get confused. The salable quantity shown on your product listing is not the same as physical stock. It equals your total source inventory minus any open reservations (orders that are placed but not yet shipped).
This distinction matters because it prevents overselling even during high-traffic periods.
Low Stock Notifications
You can configure per-source low-stock thresholds for every product. When stock drops below that threshold, Magento triggers an alert—giving your team time to reorder before a stockout occurs.
How to Set Up Magento 2 MSI: Step-by-Step
Getting MSI configured correctly is straightforward if you follow the right sequence. Here’s how to do it.
Step 1: Create Your Sources
Navigate to Stores > Inventory > Sources in the Magento admin. Click Add New Source and fill in:
- Name and Code (code cannot be changed later)
- GPS coordinates or address
- Contact information
- Enable/Disable status
Repeat for each physical fulfillment location.
Step 2: Create and Configure Stocks
Go to Stores > Inventory > Stocks and click Add New Stock. Assign:
- A name for the stock
- The sales channel (website) it will serve
- The sources it should pull from
The default stock is pre-assigned to the default source and cannot be deleted. Custom stocks are what enable multi source inventory Magento 2 across different regions or channels.
Step 3: Assign Sources to Products
Open a product in Catalog > Products, scroll to the Sources section, and click Assign Sources. Select the relevant sources, then set:
- Quantity per source
- Stock status (In Stock / Out of Stock)
- Notify Quantity threshold
This step connects your physical inventory to what customers see on the storefront.
Step 4: Let the SSA Handle Fulfillment
Once configured, the Source Selection Algorithm automatically recommends the best fulfillment source when an order comes in. Admins can accept the recommendation or manually select a source if needed.
MSI Configuration: Common Scenarios
| Business Type | Recommended Setup |
| Single warehouse | Use default source and stock; MSI still improves tracking |
| Multiple warehouses, one website | Create sources per warehouse, map all to one stock |
| Multiple websites, multiple regions | Create region-specific stocks, assign dedicated sources |
| Drop-shipping + owned warehouse | Add drop-shipper as a source; use SSA priority rules |
This flexibility is one reason why Magento development services consistently recommend MSI even for stores that aren’t yet operating at enterprise scale.
MSI and Third-Party Integrations
POS Integration
If you run physical retail locations alongside your online store, Magento POS integration with MSI enables real-time inventory sync. POS transactions update stock at the source level instantly, so your online storefront never shows inventory that’s already been sold in-store. Learn more about how Magento POS integration works with your existing setup.
WMS and ERP Connections
Magento 2’s REST API allows multi source inventory Magento 2 to connect directly with warehouse management systems (WMS) and ERP platforms. This enables automated stock updates, shipment confirmations, and return processing without manual data entry.
Third-Party MSI Extensions
Several Magento marketplace extensions extend MSI with features like virtual stock pooling, advanced picking logic, and cross-website inventory sharing. These are worth evaluating once you’ve outgrown the default SSA.
MSI vs. Single Source Inventory: When to Switch
Merchants sometimes ask whether MSI is worth enabling if they only have one warehouse. The answer is yes—for two reasons.
First, salable quantity tracking in MSI is more accurate than the legacy single-source system. Second, enabling MSI now means no migration headache when you eventually expand to additional locations.
If you’re exploring a platform move or considering whether Magento fits your growth trajectory, the Magento Open Source vs Magento Commerce comparison is a useful reference for understanding what’s available at each tier.
Comparison: Default SSA vs. Custom SSA
| Feature | Default SSA | Custom SSA |
| Setup complexity | Low | High (requires development) |
| Fulfillment logic | Distance + availability | Fully configurable |
| Best for | Standard multi-location ops | Complex fulfillment rules |
| API required | No | Yes |
For most merchants, the default SSA delivers strong results without additional development cost.
Common Mistakes to Avoid
- Locking in source codes without planning. Source codes are permanent. Create a naming convention before you start adding sources—something like warehouse_chicago rather than wh1.
- Confusing salable quantity with physical stock. Always check your reservation logs if salable quantity looks off. Unfulfilled orders place holds on inventory that don’t reduce physical stock until shipment.
- Assigning too many sources to one stock. More sources per stock means more SSA computation per order. Group sources logically and only assigns what’s needed for each sales channel.
- Skipping low-stock thresholds. Per-source thresholds are one of the most valuable features in Magento multi source inventory. Set them during initial configuration, not after your first stockout.
For teams managing complex upgrades or implementations, working with experienced Magento developers can prevent these errors from becoming expensive problems.
Key Takeaways
- Magento 2 Multi Source Inventory is a native feature (available from 2.3+) that enables multi-location inventory management without third-party extensions.
- The Source Selection Algorithm automates fulfillment decisions—you don’t need custom development to get started.
- MSI benefits single-location merchants too, through improved salable quantity accuracy and future-proofed infrastructure.
- Source codes are permanent; plan your naming structure before setup.
- POS and WMS integrations are supported natively via REST API.
Conclusion
Magento 2 Multi Source Inventory gives growing merchants the infrastructure to manage inventory at scale without losing control or accuracy. Whether you’re running two warehouses or ten storefronts, the MSI framework handles the complexity so your team doesn’t have to.
If you’re planning to implement or upgrade MSI and want to avoid common configuration mistakes, talk to our Magento team for a free consultation. You can also explore our guide on upgrading Magento 2 to the latest version to ensure your store is running on a supported release before enabling MSI.
Frequently Asked Questions About Magento 2 Multi Source Inventory
What Is Magento 2 Multi Source Inventory (MSI)?
MSI is Magento’s native inventory management system, introduced in version 2.3. It allows merchants to manage stock across multiple warehouses, storefronts, and fulfillment centers from a single admin panel, with automated source selection for order fulfillment.
Does Multi Source Inventory Magento 2 Work for Single-Warehouse Stores?
Yes. Single-location merchants benefit from improved salable quantity tracking and reservation accuracy. Enabling MSI now also makes future expansion to multiple sources much simpler.
What Is the Source Selection Algorithm in Magento MSI?
The Source Selection Algorithm (SSA) determines which source fulfills each order based on stock availability and shipping proximity. The default Distance Priority SSA works for most operations; custom algorithms can be built via API for complex rules.
Can I Disable Magento 2 Multi Source Inventory?
You cannot fully remove MSI from Magento 2.3+, but you can operate exclusively through the default source and stock, which mimics single-source behavior without disabling the system.
How Is Salable Quantity Calculated in Multi Source Inventory Magento 2?
Salable quantity equals total physical stock across assigned sources minus open reservations (placed but unfulfilled orders). It is not the same as your raw stock count.
What Third-Party Systems Can Integrate With Magento Multi Source Inventory?
MSI integrates with POS systems, ERP platforms, and warehouse management systems via Magento’s REST API. Real-time sync ensures inventory accuracy across all channels.
Can Source Codes Be Edited After Creation?
No. Source codes are permanent in Magento 2 MSI. Plan your naming convention carefully before creating sources to avoid confusion later.
