Data Sync Overview

MerchantFlow data sync is the background process that pulls commerce, analytics, advertising, and fulfillment data from your connected integrations into your workspace. Sync jobs run automatically on a recurring schedule, ensuring your dashboard stays current without manual intervention.

How the Sync Model Works

MerchantFlow uses queue-backed background jobs rather than a single foreground sync process.

That means:

• sync requests can be queued and processed in order
• jobs can continue while you navigate elsewhere in the dashboard
• the dashboard refreshes after background processing completes
• one stale provider does not necessarily mean the entire workspace is disconnected

What Is the Default Sync Frequency?

MerchantFlow runs recurring delta syncs for active live workspaces.

• the default recurring delta cadence is roughly every 30 minutes
• exact freshness still depends on provider-side reporting latency
• a recent manual sync does not disable the normal background cadence

Where to Monitor Sync Health

Use these surfaces to check the current state of your data:

• the Live indicator in the dashboard header
• the Integration Health dropdown opened from that indicator
• Settings > Integrations
• Settings > Logs

The Integration Health dropdown is the fastest status view. It shows:

• provider-level health
• last synced time
• warnings or error messages
• the next scheduled sync countdown

How to Trigger a Manual Sync

MerchantFlow supports two user-facing manual sync entry points:

Quick sync from the dashboard

Use the Live indicator for a fast "sync all" request. This submits a background job for every connected provider.

Detailed sync from settings

Use Settings > Integrations > Manual Sync Runner when you need:

• a provider-specific sync
• a standard incremental sync
• a full historical-style sync

See the Manual Sync guide for step-by-step instructions.

Who Can Trigger Syncs?

Manual sync requires:

• onboarding completion
• active subscription or trial access for the live workspace
• a role with sync:trigger permission

Owners, admins, and analysts can trigger syncs. Viewers can inspect integration status but cannot trigger live sync jobs.

Frequently Asked Questions

How often does MerchantFlow sync my data?

MerchantFlow runs recurring delta syncs approximately every 30 minutes for active workspaces. Provider-side reporting latency may affect the freshness of specific metrics such as Google Analytics or ad platform data.

Can I sync only one integration instead of all of them?

Yes. Use Selective Sync in the Manual Sync Runner to target a specific provider such as Shopify, Google, Meta, or TikTok.

What happens if a sync job fails?

Failed jobs are logged with error details. You can review them in Settings > Logs. Common causes include expired OAuth tokens and disconnected integrations. See Sync Troubleshooting for resolution steps.

Does triggering a manual sync reset the automatic schedule?

No. A manual sync does not disable or delay the normal background sync cadence.

Related Pages

• Manual Sync - Quick sync and detailed sync runner
• Selective Sync - Provider-specific sync control
• Sync Status - Understand job states
• Sync Troubleshooting - Fix stale or incomplete data
• Connect Integrations - Initial setup
• First Sync - Post-onboarding data verification
• Dashboard Overview - Navigate your analytics
• Troubleshooting - General issue resolution

---

Last updated: March 14, 2026