Sync Status

Sync status in MerchantFlow reports the current state of each background data synchronization job. Understanding these states helps you determine whether your dashboard data is fresh, in progress, or needs attention.

What Are the Current Sync States?

Queued

The request was accepted and is waiting for a worker. Jobs typically move from queued to running within seconds.

Running

The job is actively syncing data from the provider in the background.

Completed

The sync finished successfully and fresh data is available in the dashboard.

Failed

The sync did not finish successfully and needs review. Check integration health and logs for the specific error.

Short-Lived Request Messages

You may also see temporary UI messages such as:

• Submitting - the request is being sent
• Request Submitted - the server acknowledged the request
• Request Failed - the request could not be submitted

Those are button-level request states. The underlying job status still settles into queued, running, completed, or failed.

Where to Check Sync Status

• Dashboard Live indicator - quick signal on workspace freshness
• Dashboard Integration Health dropdown - provider-by-provider health, last synced time, warnings, and next sync estimate
• Settings > Integrations - reconnect controls, manual sync runner access, and provider-specific status messages
• Settings > Logs - recent sync history rather than just the latest health snapshot

What to Look For When Checking Status

Check:

• whether the job is queued or already running
• the last successful sync time for each provider
• whether only one provider is failing while others look healthy
• whether the issue is a connection error, an account-selection problem, or normal provider latency

What Happens If a New Sync Request Is Rejected

MerchantFlow may reject duplicate requests if another sync is already in progress. That usually means you should let the existing run finish before submitting another full request.

What to Do If a Sync Looks Stuck

There is not currently a standard customer-facing "cancel sync" control in the dashboard UI.

If a job appears stuck:

• wait a few minutes to rule out provider delay
• review the related integration health and logs
• rerun a targeted sync if the previous run has finished
• contact [email protected] if the same job remains stuck and needs a reset

Frequently Asked Questions

How do I know if my data is up to date?

Check the Integration Health dropdown from the Live indicator. It shows the last synced time for each provider and the next scheduled sync countdown.

Why does my sync show "Queued" for a long time?

The sync queue may be busy processing other jobs. Wait briefly and refresh the status view. If the queue clears without your job starting, review integration health before retrying.

Can I cancel a running sync job?

Not through the dashboard UI at this time. If a job needs to be manually reset, contact [email protected].

What does it mean if all providers show "Failed"?

Simultaneous failures across all providers usually indicate a network issue or an expired primary OAuth connection. Check your internet connection and verify that your Google or platform credentials have not been revoked.

Related Pages

• Dashboard Overview - Navigate your analytics workspace
• Sync Overview - Background sync model
• Manual Sync - Trigger on-demand syncs
• Selective Sync - Provider-specific sync
• Sync Troubleshooting - Fix stale or failed data

---

Last updated: March 14, 2026