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 "Connected." Reconnect any showing "Disconnected."
-
Check sync status - Go to Settings > Logs. Verify the last sync completed successfully. If failed, view error details and retry.
How to Fix Login Problems
Symptoms: "Invalid email or password" error, account locked message, email not verified.
Solutions:
-
Reset password - Go to the forgot password page, enter your email, and follow the reset link.
-
Verify email - Check your inbox (including spam) for a verification email from [email protected]. Click the verification link.
-
Clear browser cache - Press Ctrl+Shift+Del, clear cookies and cache, or try an incognito/private window.
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 - Go to Settings > Logs, click the failed sync for error details, and address the specific error mentioned.
-
Common sync errors:
- "Authentication failed" - OAuth token expired. Reconnect the integration in Settings.
- "Rate limit exceeded" - Wait 1 hour before retrying.
- "Invalid credentials" - For WooCommerce, regenerate API keys. For others, reconnect via OAuth.
How to Fix Missing Products
Symptoms: Products missing from table, product count lower than expected.
Solutions:
-
Check product status - Products must be Active in Shopify or Published in WooCommerce. Archived and draft products do not sync.
-
Clear filters - Remove any applied filters in the products table and clear the search box.
-
Verify sync completion - Products sync at the end of the sync process. Refresh the page after 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 uses last-click attribution, which may differ from GA4's model. Small differences are normal.
Common Error Messages
| Error Message | Cause | Fix |
|---|---|---|
| "Session expired" | Inactive session timeout | Log in again |
| "Permission denied" | Insufficient role access | Contact account owner |
| "Rate limit exceeded" | Too many API requests | Wait 1 hour |
| "Network error" | Connection issue | Check internet, disable VPN |
| "Something went wrong" | Generic application error | Refresh 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]
- Response time: Typically within 4 hours during business hours (24-hour maximum)
- Live chat: Available in dashboard (bottom right), weekdays 9 AM - 6 PM EST
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 uses last-click attribution and calculates revenue from synced order data, while GA4 may use different attribution models and includes sampled data. 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.
Where can I check if MerchantFlow is experiencing an outage?
Visit status.merchantflow.ai to check for ongoing incidents or planned maintenance.
Related Resources
- Getting Started - Setup guides
- FAQ - Common questions
- Dashboard Guide - Dashboard navigation
- Sync Guide - Data sync documentation
Last updated: March 14, 2026
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.