Manual Sync

Manual sync in MerchantFlow lets you pull fresh data from your connected integrations on demand, without waiting for the next automatic background cycle. It is useful when you need up-to-the-minute metrics for reporting, after reconnecting an integration, or when troubleshooting stale data.

How to Run a Quick Sync from the Dashboard

From most merchant dashboards:

1. Click the Live indicator in the header
2. Open the Integration Health dropdown
3. Choose Sync All Integrations

This submits a background sync request for every connected provider. It does not keep you on a blocking loading screen, so you can continue using the dashboard while the sync processes.

How to Run a Detailed Sync from Settings

For more control, open Settings > Integrations > Manual Sync Runner.

The runner supports these scopes:

• All
• Google
• Shopify
• WooCommerce
• Meta
• Snapchat
• TikTok
• Speedfulfill

Understanding Sync Depth Modes

The Manual Sync Runner offers two depth modes:

• Standard - incremental updates from the last sync point
• Full - a broader reprocessing pass for that scope

The current UI labels full mode as Full History and warns that it can take significantly longer on large catalogs.

Operationally:

• Standard sync is the normal first choice for day-to-day refreshes
• Full sync is the recovery option when data was reconfigured, you changed providers, or you need a broader rebuild
• Full historical runs can take up to 30 minutes depending on workspace size

For Speedfulfill, standard mode prioritizes current fulfillment gaps and full mode broadens the pull.

Requirements for Manual Sync

Manual sync is only available when:

• onboarding is complete
• the workspace has active trial or subscription access
• you have permission to trigger syncs (owner, admin, or analyst role)

What Happens After You Click Sync

MerchantFlow submits a background request and returns one of the current job states:

• Queued - waiting for a worker
• Running - actively syncing
• Completed - finished successfully
• Failed - needs review

You can leave the page and return later. See Sync Status for details on what each state means.

What Manual Sync Does Not Do

• It does not bypass billing or onboarding requirements
• It does not guarantee that provider-side latency disappears immediately
• It does not currently expose a customer-facing cancel button for an in-flight job

Frequently Asked Questions

How long does a manual sync take?

A standard incremental sync typically completes within 2 to 5 minutes. A full history sync can take up to 30 minutes for large catalogs with thousands of products and extensive order history.

Can I cancel a manual sync once it starts?

There is no customer-facing cancel button in the current dashboard UI. If a job appears stuck, wait a few minutes and then contact [email protected].

Does a manual sync override the automatic schedule?

No. A manual sync runs in addition to the regular background cadence. The automatic sync schedule continues unaffected.

Why does my manual sync show "Failed"?

Common causes include disconnected integrations, expired OAuth tokens, and missing account selections. Fix the underlying issue and then rerun the sync. See Sync Troubleshooting for detailed resolution steps.

Related Pages

• Sync Overview - How background sync works
• Selective Sync - Target a specific provider
• Sync Status - Job state reference
• Sync Troubleshooting - Fix stale or failed syncs
• No Data Troubleshooting - Empty dashboard fixes

---

Last updated: March 14, 2026