Configuration

Multistore Sync Documentation

Multistore Sync uses a primary/child model. The primary store is the stock source of truth. Child stores receive stock from the primary and push orders back. Both sites have the plugin installed — the role is determined by how you configure it after activation.

Primary Store

Connected Stores

Multistore Sync → Connected Stores

This is where child stores are registered. For each child store you add:

FieldDescription
Store NameA friendly label, e.g. "Sydney Store"
Store URLThe full URL of the child site
Auth MethodOAuth (automatic, requires HTTPS on both sites) or Manual API Keys (works on HTTP/local)
Consumer Key / SecretManual auth only — generate on the child site via WooCommerce → Settings → Advanced → REST API, set to Read/Write

After adding, each store shows its status (Connected / Pending / Error), last sync time, and actions: Sync Settings, Check Connection, Remove.

Sync Settings

Multistore Sync → Sync Settings

Configured per connected store. Select which product categories from the primary are synced to each child.

  • Initial / force sync — products in selected categories are created or updated on the child (matched by SKU)
  • Ongoing — only stock quantities update automatically; product data is not changed after the initial sync
  • Force Sync All Categories — triggers an immediate full sync across all selected categories
  • Per-category Sync — triggers a sync for that category only

General Settings

Multistore Sync → General Settings

SettingDefaultNotes
Stock buffer 0 Units withheld from each child. E.g. 10 in stock with a buffer of 2 means children receive 8.
Variable product sync Enabled Syncs variations (SKU, stock, attributes, price) during a force sync.
Delete sync Disabled Permanently deleted products on the primary are deleted on child sites too. Moving to trash does not trigger this.
Auto-purge logs after 90 days Log entries older than this are deleted once per day. Accepts 1–3650 days.
Delete all data on uninstall Disabled If enabled, uninstalling drops all plugin tables, options, logs, and SKU maps. This is irreversible.

Maintenance actions available on this page:

  • Purge All Logs — immediately deletes all activity log entries
  • Reset to Pending — only shown when stuck processing queue rows exist (e.g. after a server crash or fatal error). Resets them so the next sync picks them up.

Activity Log

Multistore Sync → Activity Log

View all sync events with timestamp, action type, status (Success / Error), and message. Display only — no settings to configure here.

Child Store

Connection to Primary Store

Multistore Sync → Connection

FieldDescription
Primary Store URLThe full URL of the primary store

Enter the primary store URL and click Save & Authorise. The child redirects to the primary store to complete the OAuth handshake. On return, the connection is active. Once connected, the page shows the connected primary URL and a Disconnect button that stops all sync.

Sync Status

Multistore Sync → Sync Status

Read-only monitoring dashboard showing:

  • Primary Store Connection — Connected & Reachable / Unreachable / Not Connected
  • Last Stock Sync — timestamp and message of the most recent stock sync received
  • Last Order Sync — timestamp and success/error status of the most recent order push
  • Errors (last 24h) — error count with recent log entries (time, action, message)
  • Recent Activity — full recent log table