Fix Browser Issues in MerchantFlow

Browser issues in MerchantFlow include display problems, loading failures, session expiry, and rendering errors that prevent the dashboard from functioning correctly. Most browser issues can be resolved by clearing your cache, updating your browser, or disabling interfering extensions.

Supported Browsers

MerchantFlow works best on modern browsers:

• Chrome (recommended) -- Version 90+
• Firefox -- Version 90+
• Safari -- Version 15+
• Edge -- Version 90+

Internet Explorer is not supported.

How to Fix a Dashboard That Will Not Load

Symptoms: Blank page, spinner that never stops, or error message.

Fix:

1. Hard refresh -- Press Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
2. Clear cache -- Press Ctrl+Shift+Del and clear cached images and files
3. Try incognito -- Open MerchantFlow in a private/incognito window
4. Disable extensions -- Ad blockers or privacy extensions may interfere
5. Check internet -- Verify your connection is stable

How to Fix Charts Not Rendering

Symptoms: Empty chart areas or broken visualizations.

Fix:

1. Ensure JavaScript is enabled in your browser
2. Disable any ad blockers that may block chart libraries
3. Try a hard refresh (Ctrl+Shift+R)
4. Try a different browser to isolate the issue

How to Handle Session Expired Messages

Symptoms: Redirected to login page unexpectedly.

MerchantFlow sessions expire after 12 hours of inactivity for security:

• Sessions update every hour while you are active
• Cookie cache is valid for 5 minutes
• If your session expires, simply log in again

Fix: Log in again. Your data and settings are preserved.

How to Fix Slow Dashboard Performance

Symptoms: Pages load slowly, interactions feel sluggish.

Fix:

1. Close unnecessary browser tabs (each tab uses memory)
2. Clear browser cache and cookies for merchantflow.ai
3. Check your internet speed
4. Disable browser extensions temporarily
5. Try a different browser

How to Fix OAuth Popup Blocked

Symptoms: Clicking "Connect" does nothing or shows a popup blocker warning.

The OAuth flow for connecting integrations opens a popup window:

1. Check for a popup blocker notification in your browser's address bar
2. Allow popups from merchantflow.ai
3. Disable popup blocker temporarily for the connection step
4. Try clicking the "Connect" button again

What to Do When You See an Error Boundary

If MerchantFlow encounters a rendering error, it shows an error boundary message rather than a blank screen. If you see this:

1. Click the "Retry" button if available
2. Hard refresh the page
3. If the error persists, note the error message and contact support

How to Clear Browser Data

Chrome

1. Press Ctrl+Shift+Del
2. Select "Cached images and files" and "Cookies and other site data"
3. Set time range to "All time"
4. Click "Clear data"

Firefox

1. Press Ctrl+Shift+Del
2. Select "Cache" and "Cookies"
3. Set time range to "Everything"
4. Click "Clear Now"

Safari

1. Go to Safari > Settings > Privacy
2. Click "Manage Website Data"
3. Find merchantflow.ai and click "Remove"

Frequently Asked Questions

Which browser works best with MerchantFlow?

Google Chrome (version 90 or later) is the recommended browser. MerchantFlow is optimized for Chrome and it provides the most consistent experience.

Why does my session keep expiring?

Sessions expire after 12 hours of inactivity. If sessions expire more frequently, check that your browser allows cookies from merchantflow.ai and that you have not enabled settings that clear cookies on browser close.

Can I use MerchantFlow on a mobile browser?

Yes. MerchantFlow is a responsive web application that works on mobile browsers including Safari on iOS and Chrome on Android. For the best experience, use landscape orientation on tablets.

Do ad blockers interfere with MerchantFlow?

Some ad blockers can block chart rendering libraries or API requests that MerchantFlow needs. If you experience display issues, try disabling your ad blocker for merchantflow.ai.

Related Pages

• Login Issues -- Cannot sign in
• No Data Showing -- Empty dashboard
• Troubleshooting Overview -- All troubleshooting guides

---

Last updated: March 14, 2026