# Commerce inventory sync URL: https://support.starshipit.com/articles/14700000000018-commerce-inventory-sync Canonical: https://support.starshipit.com/articles/14700000000018-commerce-inventory-sync Markdown: https://support.starshipit.com/articles/14700000000018-commerce-inventory-sync.md Updated: 2026-05-07 > For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt). > Automatically sync WMS inventory changes back to connected commerce platforms and run bulk manual syncs to keep storefront stock levels accurate. If your Starshipit account is connected to supported commerce platforms, Starshipit WMS can write inventory changes back automatically. This means your storefront stock levels stay in sync with your actual warehouse stock without manual updates. There are two sync modes: * **Automatic writeback** — runs after WMS stock movements for enabled products and stores. * **Manual bulk sync** — pushes selected products to a connected platform on demand. Both modes use the account-level integration settings and respect any per-product, per-store, or per-platform overrides you have configured. Supported commerce sync areas include Shopify, BigCommerce, WooCommerce, Cin7 Omni, Unleashed, and Magento 2. The exact controls shown in WMS depend on which integrations are connected to your Starshipit account. ## How automatic writeback works When a stock movement completes in WMS — such as a receipt, pick, adjustment, or stocktake variance — enabled commerce inventory writeback runs automatically: 1. WMS completes the stock movement transaction. 2. An inventory update is placed in the commerce sync queue. 3. The queue processes asynchronously in the background. **This is non-blocking.** If the commerce platform is temporarily unavailable or the update fails, the WMS transaction still completes — your warehouse operations are not paused waiting for an external system to respond. Sync failures are logged to the **process logs** in WMS so you can review and investigate without them appearing as operational alerts. This applies to all inbound and outbound movements including: * Receiving purchase orders (direct, staged, or cross-dock) * Picks and shipments * Manual stock adjustments * Stocktake variances ## Running a manual bulk sync You can push inventory for specific products to a connected platform at any time from the inventory dashboard: 1. Go to the **Inventory** dashboard. 2. Select the products you want to sync. 3. Use the platform-specific sync action, such as **Sync to Shopify**. A manual bulk sync usually pushes the **absolute on-hand quantity** for those products to the selected platform, overwriting whatever that platform currently shows. Use this: * After a large stocktake to ensure storefront stock reflects corrected levels * When setting up WMS for the first time to initialise storefront stock with accurate quantities * When you suspect WMS and a commerce platform have drifted and want to force alignment ## Enabling inventory sync Sync is controlled by account-level and platform-specific settings in WMS: 1. Go to **Products > Sync** or **System > Settings > Inventory**, depending on the connected platform. 2. Select the store, source, or writeback target you want to configure. 3. Enable automatic inventory writeback for that target. 4. Use the hard sync or manual sync option when you need to push a full inventory snapshot. Individual products can also be excluded from sync by disabling the sync flag or removing the platform mapping on the product record. This is useful for products that exist in WMS but should not have their storefront inventory managed by WMS. ## Platform-specific notes | Platform | What to check | |---|---| | **Shopify** | Select the correct store and writeback location. Multi-store accounts can route product imports and inventory writeback by source store. | | **BigCommerce** | Confirm the product or variant is linked to the correct BigCommerce inventory item and writeback location. | | **WooCommerce** | Confirm the product is connected through Commerce Link and automatic writeback is enabled. | | **Cin7 Omni** | Confirm the product is linked before enabling inventory sync. | | **Unleashed** | Confirm writeback is enabled and review process logs after the first sync. | | **Magento 2** | Confirm the Magento product mapping is present before relying on writeback. | Before syncing, WMS checks the product mapping, source store or platform link, and writeback target for each product. If a product does not have the required platform identifier, the sync for that product is skipped and logged. ## Checking sync failures and process logs Sync errors do not surface as blocking warehouse alerts. To review them: 1. Go to **System > Process Logs**. 2. Filter or search for the relevant platform, such as Shopify, Unleashed, BigCommerce, or Magento. 3. Review any failures — the log shows which SKUs were affected and what error was returned by the platform. Common reasons for sync failure include: * Inventory sync is not enabled for the product, store, or account. * The product's platform identifier is missing or incorrect. * The selected writeback location is missing or no longer valid. * The platform is rate limiting or temporarily unavailable during a large sync. ## FAQ Does a commerce sync failure cause WMS to roll back the stock movement? No. WMS stock movements are independent of commerce writeback. If the sync fails, the WMS transaction has already completed. The failure is logged to process logs for review, but your warehouse operations continue unaffected. How soon does a store update after a WMS stock movement? The sync is asynchronous and typically completes within a few seconds of the WMS movement being committed. In high-volume periods, there may be a short queue delay. Can I sync from multiple stores? Yes. If you have multiple stores connected to Starshipit, WMS maps products to the correct store based on the source store configuration and platform product identifiers. Does WMS sync inventory quantities or just changes? **Automatic writeback** usually sends adjustments after stock movements. **Manual bulk sync** sends absolute on-hand quantities, overwriting whatever the connected platform currently shows for those products.