Version 2 of Stock Sync – Migration Guide

  • -

Introduction

Version 2 of Stock Sync for WooCommerce Free / Pro has been released. It includes a lot of improvements which increase performance and usability of the plugin such as:

  • New REST API endpoints which allow syncing to happen in one request instead of two
  • Primary – Secondary Inventories instead of multiple Primary Inventories to increase performance
  • Background processing for preventing slowing the sites down
  • Batch processing for avoiding timeout and memory issues
  • Improved report page
  • Improved logging

While version 2 has been designed to be as compatible as possible with sites migrating from version 1, it has a lot of changes and testing on staging environments is recommended. Additionally, as version 2 introduces Secondary Inventories, settings need to be altered.

NOTE: Version 2 is not compatible with WooCommerce 3.x. Please update to WooCommerce 4.x before updating Stock Sync.

How to upgrade

Updating from version 1 to 2 should be straightforward. However, it’s recommended to backup the sites and select a time when there is not much sales to avoid stock discrepancies.

  1. Update from version 1 to 2 on all sites at the same time.
    1. Free: you can update directly from WordPress admin
    2. Pro: manual update from zip file is required due to potential breaking changes with setups involving more than 2 syncable sites. Please submit a ticket with your order number or email address used for the order if you don’t have version 2 zip file yet.
  2. Select one site which is Primary Inventory. Please read below for differences.
  3. Set other site(s) as Secondary Inventories at WooCommerce > Settings > Stock Sync > Role of This Site.
  4. Edit stock quantities on different sites and ensure syncing succeeds

That’s all. If you experience any issues, please submit a ticket detailing your issue.

Primary vs Secondary Inventory

You should have one Primary Inventory and 1 – 4 Secondary Inventories. If you have only two sites you want to sync, it doesn’t matter much which site is Primary. However, if you have multiple stores, please consider the following:

  • Primary Inventory should have all products which stock quantities you want to share.
  • Complete logs are only available on Primary Inventory
  • Tools (Push All and Update All) are only available on Primary Inventory

Latest Posts

Plugins