Connect your Shopify store

Connecting your Shopify store gives Retail Commerce OS a live, two-way link to your catalogue, orders, customers, and inventory — changes made in either place stay in sync automatically.

How to set it up

1. Go to App > Shopify and click Connect.
2. You'll be redirected to Shopify's OAuth screen. Review the permission scopes Retail Commerce OS needs and click Approve.
3. Once approved, Retail Commerce OS starts an initial import — it pulls in your products, orders, customers, and inventory. This import is resumable, so if your connection drops mid-way, it picks up from where it left off rather than starting over.
4. When the import finishes, continuous sync switches on automatically. From this point, Retail Commerce OS and Shopify stay in sync through a combination of webhooks (Shopify notifies Retail Commerce OS the moment something changes) and a push queue with retry logic and a dead-letter queue for any events that fail to process.

That's it — no further configuration is needed to keep the two sides talking.

How it works

Continuous sync runs in both directions. Update a product price in Retail Commerce OS and it flows to Shopify. Receive a new order in Shopify and it appears in Retail Commerce OS — usually within seconds.

Daily drift reconciliation runs in the background once a day. It compares every record on both sides and corrects any small discrepancies that webhooks may have missed (for example, due to a temporary outage).

Conflict resolution follows a simple rule: the most recently updated version wins. If the same product is edited in both places at nearly the same time, the later edit takes effect.

Sync Health and Sync History

• Sync Health tab — shows the current status of each webhook so you can see at a glance whether the connection is healthy.
• Sync History tab — logs every entity that has been synced. Each entry shows a before-and-after snapshot of what changed. You can revert a change to roll it back, or redo it if you reverted by mistake.

Good to know

• Retail Commerce OS syncs two-way with Shopify only. It does not read data from other platforms or tools.
• The initial import is resumable — you don't need to babysit it or restart it if something interrupts it.
• The retry queue and dead-letter queue mean that a temporary Shopify outage won't silently drop events; failed events are retried and flagged if they can't be processed.
• Daily reconciliation acts as a safety net, so even rare webhook gaps don't cause long-term drift between your two systems.

Troubleshooting

The initial import seems stuck. The import is resumable — if it paused due to a connectivity issue it will continue automatically. Check the Sync Health tab to confirm webhooks are active; a disconnected webhook is the most common reason an import stalls.

A change I made in Shopify isn't showing in Retail Commerce OS. Open the Sync History tab and search for the relevant product, order, or customer. If the event is listed, check the before/after snapshot to confirm what was synced. If it isn't listed at all, check Sync Health to see whether the relevant webhook is still connected.

I reverted a change by mistake. Go to Sync History, find the entry, and use Redo to reapply the change.