Troubleshooting MerchantFlow Issues
Find solutions to common MerchantFlow issues including empty dashboards, sync failures, login problems, incorrect metrics, and integration errors.
Troubleshooting Guide
MerchantFlow troubleshooting provides step-by-step solutions for common issues including empty dashboards, data sync failures, login problems, incorrect metrics, and integration errors. Use this guide to quickly diagnose and resolve problems with your e-commerce analytics workspace.
If you cannot find your answer here, contact [email protected].
Quick Links
- Login Issues - Cannot log in
- No Data Showing - Dashboard empty
- Sync Failures - Data not syncing
- Integration Errors - OAuth and connection problems
- Missing Products - Products not appearing
- Incorrect Metrics - Data seems wrong
- Browser Issues - Display and rendering problems
- Merchant Center - Feed and disapproval issues
How to Fix an Empty Dashboard (No Data)
Symptoms: Empty KPI cards, no products in table, charts show no data.
Solutions:
-
Run your first sync - Click the Live indicator in the dashboard header and select "Sync All Integrations." Wait 2-5 minutes for completion.
-
Check time range - Ensure the time range selector includes a period with activity. Try "Last 30 days."
-
Verify integrations - Go to Settings > Integrations. All required integrations should show a healthy status. Reconnect any showing an error.
-
Check sync status - Open the Audit Logs panel on Settings > Integrations. Verify the last sync completed successfully. If failed, view error details and retry.
How to Fix Login Problems
Symptoms: "Invalid email or password" error, a CAPTCHA that will not clear, or "Your session has expired. Please log in again."
Solutions:
-
Reset password - Go to the forgot password page, enter your email, and follow the reset link. The link expires after 1 hour. New passwords need at least 8 characters plus an uppercase letter, a lowercase letter, a digit, and a special character.
-
Complete the CAPTCHA - The login form runs a Turnstile check. Let it finish loading and disable extensions that block it.
-
Clear browser cache - Press Ctrl+Shift+Del, clear cookies and cache, or try an incognito/private window.
Verifying your email is not required to sign in; if your address is unverified, MerchantFlow shows a verification banner inside the dashboard instead of blocking login.
How to Fix Sync Failures
Symptoms: Sync shows "Failed" status, error message displayed, partial data syncing.
Solutions:
-
Check integration connections - Go to Settings > Integrations and verify each integration shows a healthy status. Reconnect any failing integrations.
-
Review error details - Open the Audit Logs panel on Settings > Integrations, click the failed sync for error details, and address the specific error mentioned.
-
Common health messages:
- "Authentication expired. Please reconnect your account to continue syncing." - OAuth token expired. Reconnect the integration in Settings.
- "API rate limit reached. Sync will automatically retry in a few minutes." - No action needed; avoid stacking manual syncs.
- "Integration setup incomplete. Please complete the connection in Settings." - No credential is stored. Reconnect the integration.
- "Sync already in progress" - Another sync is running for this workspace. Wait for it to finish.
How to Fix Missing Products
Symptoms: Products missing from table, product count lower than expected.
Solutions:
-
Clear filters - Remove any applied filters in the products table and clear the search box.
-
Check product status - Products are synced with the status your store reports (Active, Draft, or Archived on Shopify; Published, Draft, or Private on WooCommerce). Check that you are not filtering out the status you expect.
-
Verify sync completion - Refresh the page after the sync completes.
How to Fix Incorrect Metrics
Symptoms: Numbers do not match GA4, revenue seems wrong, conversion rates off.
Solutions:
-
Verify time zone - Go to Settings and confirm your timezone matches your GA4 property timezone.
-
Check currency - Ensure your MerchantFlow currency matches your store currency.
-
Compare time ranges - Confirm GA4 and MerchantFlow are using the same date range. Time zone differences can shift daily totals.
-
Attribution differences - MerchantFlow computes several attribution models (first touch, last touch, linear, time decay, and position based), which may differ from the model GA4 reports on. Small differences are normal.
Common Error Messages
| Error Message | Cause | Fix |
|---|---|---|
| "Your session has expired. Please log in again." | Session record removed or expired | Log in again |
| "Insufficient permissions" | Your role lacks the required permission | Ask an owner or admin to change your role |
| "Too many requests. Please try again later." | Too many unauthenticated API requests from your IP | Wait, then retry |
| "Sync already in progress" | Another sync is running for this workspace | Wait for it to finish |
| "Something went wrong" | Generic application error | Click Try Again, refresh the page, clear cache |
How to Contact Support
Before Contacting Support
Help us resolve your issue faster by including:
- Description of the issue
- Steps to reproduce
- Error messages (exact text or screenshot)
- Browser and version
- Time when issue occurred
- What you have already tried
Contact Information
- Email: [email protected] - you can also simply reply to any email MerchantFlow sends you, since replies route to the same monitored inbox
Frequently Asked Questions
Why is my MerchantFlow dashboard empty?
The most common cause is that the first data sync has not completed. Click the Live indicator, select "Sync All Integrations," and wait 2-5 minutes. Also verify that your integrations are connected at Settings > Integrations.
Why do my MerchantFlow metrics differ from Google Analytics?
MerchantFlow calculates revenue from synced order data rather than JavaScript tracking, and it computes several attribution models rather than assuming GA4's. GA4 may also sample data and applies its own processing delay. Small differences are normal and expected. See Incorrect Metrics.
How do I report a bug in MerchantFlow?
Email [email protected] with steps to reproduce, expected behavior, actual behavior, screenshots, and your browser and OS version.
How do I tell whether a problem is on MerchantFlow's side or my provider's?
Open the Integration Health dropdown from the Live indicator. If a single provider shows an error while the rest are healthy, the problem is almost always that provider's connection or API. If every provider fails at once, check your network first, then contact [email protected].
Related Resources
- Getting Started - Setup guides
- FAQ - Common questions
- Dashboard Guide - Dashboard navigation
- Sync Guide - Data sync documentation
Last updated: August 23, 2026
Last updated on
Expense Tracking FAQ
Frequently asked questions about managing business expenses, recurring costs, OPEX vs CAPEX, burn rate, and expense attribution in MerchantFlow.
Fix Browser Issues in MerchantFlow
Troubleshoot browser display problems, loading issues, session expiry, and rendering errors in MerchantFlow. Includes fixes for Chrome, Firefox, Safari, and Edge.