-
Notifications
You must be signed in to change notification settings - Fork 254
Create Stock
After you create your sources, you can create stock. Stock provides a virtual aggregated amount of inventory for your sources connected to sales channels.
- Sales channels currently include websites out-of-the-box. You can extend sales channels to include custom options like B2B customers groups and store views.
- Each sales channel can only have a single stock assigned to it. A single stock can be assigned to multiple websites.
- When you assign new stock to a sales channel, any pre-existing stock in that sales channel becomes unassigned.
With a multisite configuration, you can tailor the stocks as needed, such as geography, size of warehouse, and so on. The following are a few examples of source priority:
- For a German website, you may prioritize sources as Germany to England to France with the United States as the lowest priority. These orders fulfill through Europe with a fall-back option of the US.
- For orders originating in New York, you may prioritize warehouses in New York to Florida to Texas. For all other orders in the US, you may have the Texas warehouse as highest priority to Florida to New York.
For new installations, you start with a Default Stock. We recommend creating new stock as needed for your sales channels and sources. When you add a new website, MSI automatically creates a new stock. Review and manage your stocks for the new site when you create it.
The following diagram helps define how a Stock works in relation to Sources and Sales Channels for a Bicycle Shop merchant.
![]() |
---|
Relation of Sources and Sales Channels to Stocks |
The example tracks the inventory of Sample Product 1 at three Sources with a configured Notify for Quantity Below through the Assigned Sources. For example, the Warehouse source has an available quantity of 50 with a notify threshold of 10, giving a source salable quantity of 40.
The merchant has four Sales Channels including an eBay Marketplace and three websites (Germany, Netherlands, and the UK). The stores have an Only X Left threshold of 5 configured.
Note: The Salable Quantity displayed on the product page deducts all thresholds for at a glance aggregated totals.
The merchant creates three Stocks. Only one Sales Channel can be associated with one Stock. As all Sales Channels are websites, they can assign multiple websites to a stock, but not to more than one stock: two websites (DE and NL) to one stock and individual stocks for the marketplace (eBAY) and other website (UK).
Each stock collects all quantities from each assigned source and deducts the Notify for Quantity Below and Only X Left amounts to aggregate the Salable Quantity. For example, Bicycle Shop UK Stock accesses inventory from all three sources. The salable amount per source is 40, 15, and 5 for a total of 60. The Only X Left for all stores is 5. To determine the final salable amount for Sample Product 1 through the UK webstore is 55. Customers can add the product to their carts, completing purchases, as MSI algorithms manage reservations across the sources.
-
On the Admin sidebar, tap Stores. Then under Settings, choose Manage Stocks.
-
In the upper-right corner, tap Add New Stock.
![]() |
---|
New Stock Page |
-
(Required) Enter a unique Name for the stock.
-
In Sales Channels, assign the stock to one or more listed websites.
-
In Sources, click Assign Sources to add a source to this stock.
-
On the Assign Sources page, click the checkboxes for the sources you want to apply to the new stock. Click Done to add.
![]() |
---|
Assign Sources Page |
-
Set the prioritization of the sources in the Assigned Sources grid. The topmost source has top priority for inventory and fulfillment. Drag-and-drop to modify the source priority. This priority is used by the Source Selection by Priority Algorithm uses.
-
When done, tap Save & Continue to return to the Manage Stock page.
The following image shows four sources assigned to Stock1. The Assign Sources Algorithm tries to fulfil the order using Default first, then Test1, Test2, and Test3.
Note: The Assigned Sources priority only affects the stock. It does not influence the Assigned Sources on the per products (which are ordered by when they are added).
![]() |
---|
Changing Source Selection Algorithm Priority on the New Stock Page |
To move a source up or down, click the drag handle on the left and drag the source's rectangle.
![]() |
---|
Changed Priority of Sources on New Stock Page |
Multi-Source Inventory developed by Magento 2 Community
- Technical Vision. Catalog Inventory
- Installation Guide
- List of Inventory APIs and their legacy analogs
- MSI Roadmap
- Known Issues in Order Lifecycle
- MSI User Guide
- 2.3 LIVE User Guide
- MSI Release Notes and Installation
- Overview
- Get Started with MSI
- MSI features and processes
- Global and Product Settings
- Configure Source Selection Algorithm
- Create Sources
- Create Stock
- Assign Inventory and Product Notifications
- Configure MSI backorders
- MSI Import and Export Product Data
- Mass Action Tool
- Shipment and Order Management
- CLI reference
- Reports and MSI
- MSI FAQs
- DevDocs Documentation
- Manage Inventory Management Modules (install/upgrade info)
- Inventory Management
- Reservations
- Inventory CLI reference
- Inventory API reference
- Inventory In-Store Pickup API reference
- Order Processing with Inventory Management
- Managing sources
- Managing stocks
- Link and unlink stocks and sources
- Manage source items
- Perform bulk actions
- Manage Low-Quantity Notifications
- Check salable quantities
- Manage source selection algorithms
- User Stories
- Support of Store Pickup for MSI
- Product list assignment per Source
- Source assignment per Product
- Stocks to Sales Channel Mapping
- Adapt Product Import/Export to support multi Sourcing
- Introduce SourceCode attribute for Source and SourceItem entities
- Assign Source Selector for Processing of Returns Credit Memo
- User Scenarios:
- Technical Designs:
- Module Structure in MSI
- When should an interface go into the Model directory and when should it go in the Api directory?
- Source and Stock Item configuration Design and DB structure
- Stock and Source Configuration design
- Open Technical Questions
- Inconsistent saving of Stock Data
- Source API
- Source WebAPI
- Sources to Sales Channels mapping
- Service Contracts MSI
- Salable Quantity Calculation and Mechanism of Reservations
- StockItem indexation
- Web API and How To cover them with Functional Testing
- Source Selection Algorithms
- Validation of Domain Entities
- PHP 7 Syntax usage for Magento contribution
- The first step towards pre generated IDs. And how this will improve your Integration tests
- The Concept of Default Source and Domain Driven Design
- Extension Point of Product Import/Export
- Source Selection Algorithm
- SourceItem Entity Extension
- Design Document for changing SerializerInterface
- Stock Management for Order Cancelation
- Admin UI
- MFTF Extension Tests
- Weekly MSI Demos
- Tutorials