-
Notifications
You must be signed in to change notification settings - Fork 253
Configure MSI backorders
This content is new and in-progress for MSI and includes content for "in development" and 1.0.0 Beta features. Information may change depending on development.
Backorders allow your store to continue selling products after the quantity reaches zero, or is effectively out of stock. When a customer order is a backorder, the funds are authorized and captured immediately, the processing status of the order does not change, and the shipping remains on-hold until stock is available.
Depending on your store and sales, you may want to enable backorders globally for all products or only on specific products.
We recommend configuring specific thresholds and settings to best support backorders.
In Beta 1.0.0: When you enable backorders globally or for a product, the Out-of-Stock Threshold amount is ignored. The inventory quantity is considered unlimited or infinite. If you disable backorders, we recommend entering a positive amount.
In current development: When enabling backorders globally or per product, enter a negative amount (not positive or zero) for the Out-of-Stock Threshold. This value sets the maximum amount of products that can be backordered before the product is truly considered out of stock.
MSI adds this amount to the salable inventory. The value set at the product level overrides any value at the global level. For example, you may set the following amounts for a product:
- Quantity: 25
- Notify for Quantity Below: 5
- Out of Stock Threshold: -50
The Salable Quantity for this product is 70 (25 - 5 + 50). When customers purchase over 20 products, new orders enter as backorders. When the amount reaches 0, they have fully purchased all products and backorders, placing the product "out of stock."
Products must be set to In Stock status when enabling backorders. You can set this through the Product page. For Multi Source merchants, you must have at least one source marked as In Stock.
To enable backorders globally for all inventory in your store:
-
On the Admin sidebar, tap Stores. Then under Settings, choose Configuration.
-
Select Default Config for the Store View.
-
Tap Catalog. Then choose Catalog and Inventory.
-
Under Product Stock Options, locate Backorders. Uncheck the Use Default checkbox and select an option from the drop-down menu:
- No Backorders - Disables backorders for the entire store
- Allow Qty Below 0 - Allows for orders when the product quantity falls below zero
- Allow Qty Below 0 and Notify Customer - Allows for backorders and notifies the customer the order is a backorder
-
Under Product Stock Options, locate Out-of-Stock Threshold. Click off the Use Default checkbox to enter a specific amount:
- If you have backorders disabled, enter a positive amount over 0. For example, enter 2 to send a notification when the quantity reaches 2 or below, requiring additional stock to continue sales.
- 1.0.0 Beta: If you have backorders enabled, this value is ignored and quantity is considered infinite. You can set this to zero or a positive number.
- In Development: If you have backorders enabled, enter a negative number under 0. For example, enter -50 to allow orders up to this amount. The value is added to the Salable Quantity.
-
Tap Save Config.
You may want to enable backorders at the product level for the following:
- Globally disable backorders with specific products enabled for backorders
- Override global backorder thresholds for specific products
To enable backorders per product:
-
On the Admin sidebar, tap Catalog. Then, choose Products.
-
Select a product to edit. Scroll down the page to the Sources area.
-
Tap Advanced Inventory. A page of product specific configurations displays. Any setting listed as global displays the current global setting for the store.
-
Uncheck the Use Default checkbox and select an option from the drop-down menu:
- No Backorders - Disables backorders for the entire store
- Allow Qty Below 0 - Allows for orders when the product quantity falls below zero
- Allow Qty Below 0 and Notify Customer - Allows for backorders and notifies the customer the order is a backorder

Backorders Setting Enabled -
Under Product Stock Options, locate Out-of-Stock Threshold. Click off the Use Default checkbox to enter a specific amount:
- If you have backorders disabled, enter a positive amount over 0. For example, enter 2 to send a notification when the quantity reaches 2 or below, requiring additional stock to continue sales.
- 1.0.0 Beta: If you have backorders enabled, this value is ignored and quantity is considered infinite. You can set this to zero or a positive number.
- In Development: If you have backorders enabled, enter a negative number under 0. For example, enter -50 to allow orders up to this amount. The value is added to the Salable Quantity.
-
Tap Done then tap Save.
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