# Set up Adobe Commerce (Magento 2) with Starshipit WMS
URL: https://support.starshipit.com/articles/14700000000052-set-up-adobe-commerce-magento-2-with-starshipit-wms
Canonical: https://support.starshipit.com/articles/14700000000052-set-up-adobe-commerce-magento-2-with-starshipit-wms
Markdown: https://support.starshipit.com/articles/14700000000052-set-up-adobe-commerce-magento-2-with-starshipit-wms.md
Updated: 2026-07-28

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Import Adobe Commerce or Magento 2 products into Starshipit WMS and configure location-aware inventory writeback for each store.

Connect Adobe Commerce, also known as Magento 2, through Starshipit, import its products into Starshipit WMS, and keep inventory aligned for each connected store.

## Before you begin

You need:

* An Adobe Commerce or Magento 2 store connected to the current Starshipit account or an eligible source account.
* Permission to manage products and commerce settings in WMS.
* Unique, non-empty SKUs on the products you want to manage.
* An active Adobe Commerce inventory location for each writeback target.

If the store is not connected yet, [connect Adobe Commerce to Starshipit](/articles/213430403-connect-adobe-commerce-magento-2-to-starshipit) first.

:::important
Decide whether WMS or another system owns Adobe Commerce inventory before enabling writeback. A manual WMS sync sends the current WMS on-hand quantity to the selected location.
:::

## Import products from Adobe Commerce

WMS labels this provider **Magento2** in product-sync and inventory-writeback controls.

1. Go to **Products** in WMS.
2. Open the actions menu and select **Sync from Magento2**.
3. Choose the product fields to import.
4. Optionally enter SKU filters to limit the import.
5. Select **Start Sync**.
6. Review the result, then open a product and confirm its Magento2 source and SKU.

Products are matched by SKU. The import creates the product link used for inventory writeback.

## Configure Adobe Commerce inventory writeback

1. Go to **System > Settings > Inventory Writeback**.
2. Find **Magento2 Inventory Sync**.
3. Review the default store and any linked source stores.
4. Select a **Writeback Location** for each store WMS should update.
5. Turn on **Auto Writeback** for each configured store.

The default row is used when a product is not assigned to a specific source store. A linked row uses that product's source Starshipit account and Magento 2 store.

Only products connected to Magento 2 and assigned to a target with an active location can be written back.

## Understand automatic writeback

After a supported receipt, pick, shipment, manual adjustment or stocktake variance completes, WMS queues the Adobe Commerce update in the background. The warehouse transaction does not wait for Adobe Commerce and is not rolled back if the update fails.

You can disable Magento 2 writeback for an individual product when WMS should not manage that product's store inventory.

## Run a manual inventory sync

1. Go to **Inventory**.
2. Select the Magento 2-linked products you want to update.
3. Select **Sync to Magento2**.
4. Review the products and current WMS quantities.
5. Select **Sync to Magento2** to queue the writeback.
6. Go to **System > Process Logs** and confirm the updates completed.

Products without an enabled Magento 2 link and writeback target are skipped.

## Verify the integration

1. Import a test product from Magento 2.
2. Select its store's writeback location.
3. Enable **Auto Writeback** for that store.
4. Complete a controlled stock adjustment in WMS.
5. Confirm the quantity changed at the selected Adobe Commerce location.
6. Check **System > Process Logs** for the Magento 2 result.

## Troubleshooting

| Problem | What to check |
| --- | --- |
| Magento 2 does not appear in WMS settings | Confirm Adobe Commerce is connected to the current or eligible source Starshipit account, then refresh the settings page. |
| No stores are listed | Import products from Magento 2 or confirm the current Starshipit account has an Adobe Commerce connection. |
| No locations are available | Confirm the connected store has an active inventory location, then refresh **Magento2 Inventory Sync**. |
| **Auto Writeback** is unavailable | Select a **Writeback Location** for the target first. |
| A product is skipped | Confirm the product was imported or linked to Magento 2 and its provider writeback has not been disabled. |
| A quantity does not change | Check the product's source store, selected location and **System > Process Logs** for the returned Adobe Commerce error. |

If the problem continues, contact [Starshipit support](https://help.starshipit.com) with the WMS account, Adobe Commerce store, SKU, selected location and approximate time of the sync.

## Related articles

* [Understand WMS integrations](/articles/14700000000044-understand-wms-integrations)
* [Configure WMS products and inventory](/articles/14700000000006-starshipit-wms-products-and-inventory-configuration)
* [Maintain stock accuracy and make adjustments](/articles/14700000000017-stock-integrity-and-adjustments)