Install and Update Inventory Management

Inventory Management modules provide all inventory features and options for single- and multi-source merchants to manage product quantities and stock for sales channels. These features are available in 2.4.x releases of Adobe Commerce and Magento Open Source.

These features and extensions were developed as part of the Inventory project through the Magento Open Source Community Engineering program.

Inventory Management installs in 2.3.x and 2.4.x releases of Adobe Commerce and Magento Open Source, with all features enabled by default. No additional steps are required for enabling these inventory features. Upgrades from v2.1.x or 2.2.x may require additional steps. See Upgrade Inventory Management.

Installation according to Install Using Composer is recommended. Install with a metapackage to receive all Inventory Management modules.

The following line in the composer.json metapackage installs Inventory Management:

        magento/inventory-composer-metapackage = 1.1.3

For a list of Inventory Management metapackage versions, see the release notes.

The Inventory Management installation process adds all modules to the <Magento_installation_directory>/app/etc/config.php file. A 1 value indicates that the corresponding module is enabled. The following list of modules is added:

        'Magento_Inventory' => 1,
        'Magento_InventoryAdminUi' => 1,
        'Magento_InventoryAdvancedCheckout' => 1,
        'Magento_InventoryApi' => 1,
        'Magento_InventoryBundleProduct' => 1,
        'Magento_InventoryBundleProductAdminUi' => 1,
        'Magento_InventoryCatalog' => 1,
        'Magento_InventorySales' => 1,
        'Magento_InventoryCatalogAdminUi' => 1,
        'Magento_InventoryCatalogApi' => 1,
        'Magento_InventoryCatalogSearch' => 1,
        'Magento_InventoryConfigurableProduct' => 1,
        'Magento_InventoryConfigurableProductAdminUi' => 1,
        'Magento_InventoryConfigurableProductIndexer' => 1,
        'Magento_InventoryConfiguration' => 1,
        'Magento_InventoryConfigurationApi' => 1,
        'Magento_InventoryDistanceBasedSourceSelection' => 1,
        'Magento_InventoryDistanceBasedSourceSelectionAdminUi' => 1,
        'Magento_InventoryDistanceBasedSourceSelectionApi' => 1,
        'Magento_InventoryElasticsearch' => 1,
        'Magento_InventoryExportStockApi' => 1,
        'Magento_InventoryIndexer' => 1,
        'Magento_InventorySalesApi' => 1,
        'Magento_InventoryGroupedProduct' => 1,
        'Magento_InventoryGroupedProductAdminUi' => 1,
        'Magento_InventoryGroupedProductIndexer' => 1,
        'Magento_InventoryImportExport' => 1,
        'Magento_InventoryCache' => 1,
        'Magento_InventoryLowQuantityNotification' => 1,
        'Magento_InventoryLowQuantityNotificationApi' => 1,
        'Magento_InventoryMultiDimensionalIndexerApi' => 1,
        'Magento_InventoryProductAlert' => 1,
        'Magento_InventoryRequisitionList' => 1,
        'Magento_InventoryReservations' => 1,
        'Magento_InventoryReservationCli' => 1,
        'Magento_InventoryReservationsApi' => 1,
        'Magento_InventoryExportStock' => 1,
        'Magento_InventorySalesAdminUi' => 1,
        'Magento_InventorySalesFrontendUi' => 1,
        'Magento_InventorySetupFixtureGenerator' => 1,
        'Magento_InventoryShipping' => 1,
        'Magento_InventorySourceDeductionApi' => 1,
        'Magento_InventorySourceSelection' => 1,
        'Magento_InventorySourceSelectionApi' => 1,
        'Magento_InventoryLowQuantityNotificationAdminUi' => 1,
        'Magento_InventoryShippingAdminUi' => 1,
        'Magento_InventoryGraphQl' => 1,

Enable Inventory Management features

When installed, upgraded, or updated, the Manage Stock option in the Admin is enabled by default. This option enables inventory tracking and management, but does not affect module status. To disable modules, see the next section.

For more information about configurations, see Configure Inventory Management.

Disable Inventory Management

You may want to disable Inventory Management modules to:

  • Speed up the upgrade process for merchants migrating from 2.0.x, 2.1.x, 2.2.x, or 2.3.x to 2.4.x.
  • Use custom or third-party inventory and order management system modules.

See the Enable or disable modules topic for information about how to disable the applicable modules.

When complete, the system provides a list of modules and values in <Magento_installation_directory>/app/etc/config.php, beginning with:

   'Magento_Inventory' => 0,
   'Magento_InventoryAdminUi' => 0,
   'Magento_InventoryAdvancedCheckout' => 0,

If you have the OMS Connector modules installed, make sure that you do not disable the Magento_InventoryMessageBus module, which is a Connector module. It is required to use the Connector with OMS.

Upgrade Inventory Management

Previous Commerce versions

When upgrading or updating an existing 2.1.x, 2.2.x, or 2.3.x installation to Adobe Commerce or Magento Open Source 2.4.x, Inventory Management modules are disabled by default. This default setting is a precaution to prevent backward incompatible upgrades and to better support Order Management (OMS).


Order Management does not support Inventory Management. When upgrading, Inventory Management modules are disabled to allow OMS and Commerce 2.3.x to work seamlessly.

To enable Inventory Management modules:

  1. Edit the <Commerce_installation_directory>/app/etc/config.php file.

  2. Modify all Inventory modules from 0 to 1 to enable.

  3. Update the database:

    bin/magento setup:upgrade
  4. Clean the cache:

    bin/magento cache:clean

It is recommended that you use the reservation inconsistencies commands after upgrading. When upgrading, all of your products are added to the Default Stock. If you have pending orders, the commands correctly update your salable quantity and reservations for sales and order fulfillment.

Previous Inventory Management versions

When upgrading from previous releases of Inventory Management to the latest version, follow normal extension upgrade steps.

For the latest, update your metapackage version:

        magento/inventory-composer-metapackage = 1.1.3

See the following guides for more information about Commerce upgrades:

On this page