Skip to main content

Initial sync stuck or failing

The initial sync is the step where RevoStock pulls your products, variants, and order history from Shopify for the first time. It starts automatically when you start your free trial, and shows its progress on the Connect & Sync step. It takes from under a minute for small stores to up to about 30 minutes for stores with more than 50,000 orders — the Connect & Sync step shows the estimate for your store. If the sync card appears frozen, has clearly exceeded those windows, or is showing an error, the steps below will get you moving again.

Try this​

  1. Wait a few minutes and watch the progress log. The sync card refreshes automatically every couple of seconds and streams a terminal-style log directly on the screen. Lines that say "retrying" are normal — they mean RevoStock is waiting out a Shopify rate limit and will resume automatically. Only act if the log stops updating entirely or shows a hard error message.

  2. Read the error message in the log. Common messages and what they mean:

    • "Rate limited — retrying in X seconds" — Shopify is throttling the request. Wait; RevoStock handles this automatically.
    • "Access scope mismatch" or "Unauthorized" — the app's Shopify permissions may be outdated. See step 3.
    • "Network error" or "Connection refused" — a transient issue; retry the sync (see below).

  3. Confirm the app still has access in Shopify. Open Shopify Admin, go to Apps, and verify RevoStock is still listed as an installed app. If it was removed or has a permissions warning, reinstall it from the Shopify App Store — reinstalling automatically restarts a fresh sync.

  4. Retry the sync. If the sync failed, the Connect & Sync card shows an error message and a Retry button — click Retry. If the card shows Initialize Sync instead (the sync has not started), click that to start it. Running the sync again will not create duplicate data — it safely overwrites whatever was fetched before.

  5. Trigger a manual sync from the Dashboard. If your onboarding card already shows Step 4 ("All set"), the sync may have completed partially. Use the data-sync indicator in the Dashboard page header to kick off a fresh refresh, then return to check whether the data appears.

tip

Stores with 10,000 – 50,000 orders usually take about 10–20 minutes on the first sync, and stores with more than 50,000 orders up to about 30 minutes. Keep the browser tab open so the progress log can stream fully.

Still stuck?​

If none of the steps above resolve the issue, contact RevoStock support — see Contacting RevoStock support. Include the error message from the sync log and the approximate time the sync started so the team can correlate it with server-side logs.