Troubleshooting
Common problems and how to fix them
Sync stuck on "Syncing..."
If the progress banner has been showing for more than 15 minutes, the server-side sync likely stalled (timeout, deploy, or network blip).
What to do:
- Reload the dashboard
- Click Re-sync
If the stalled sync was within the last 30 minutes, Shelfie resumes from the saved checkpoint — products already imported are not re-fetched from Shopify. You'll see a "Resuming sync" banner.
If more than 30 minutes have passed, the next sync starts from page 1 (existing products in your DB are updated, not duplicated).
If it happens repeatedly on a very large catalog (10,000+ products or variants), contact support.
Sync failed with an error
The dashboard may show Sync interrupted. Click Re-sync within 30 minutes to continue from the last successful page. Your syncProgress count shows how many products were already imported.