Fix Browser Issues in MerchantFlow

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's front-end bundle is compiled for these browser versions, so anything older may fail to render:

Browsers that are no longer maintained by their vendor are not targeted at all. 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 are valid for 30 days:

• The session record is refreshed at most once per day while you are active
• The session cookie cache is valid for 5 minutes, so a role or permission change can take up to five minutes to take effect
• Resetting your password revokes every existing session by design
• If your session expires, you see "Your session has expired. Please log in again."

Fix: Log in again. Your data and settings are preserved. Being signed out far sooner than 30 days almost always means cookies are being cleared by the browser or an extension.

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 a Connect Button That Does Nothing

Symptoms: Clicking "Connect" on an integration does not take you to the provider's authorization screen.

The OAuth flow for connecting integrations uses a full-page redirect, not a popup. MerchantFlow first asks its own API for an authorization URL, then navigates the browser to it. So a blocked popup is not the cause; a failed first request usually is.

1. Look for an inline error under the integration card. "Unable to connect with Google. Please try again." means the authorization URL could not be generated; "Connection error. Please check your internet and try again." means the request never reached MerchantFlow
2. Disable extensions that block outbound requests to merchantflow.ai
3. Allow third-party cookies for the provider you are connecting
4. Reload the page and click "Connect" again

What to Do When You See an Error Boundary

If MerchantFlow encounters a rendering error, it shows an error boundary rather than a blank screen. It reads "Something went wrong" with the note "We encountered an unexpected error. Please try again or contact support if the problem persists." If you see this:

1. Click the Try Again button
2. Hard refresh the page
3. If the error persists, note the error message and contact [email protected]

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 111 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 are valid for 30 days, so a session that drops much sooner is a browser or extension issue rather than an expiry. Check that your browser allows cookies from merchantflow.ai and that you have not enabled settings that clear cookies on browser close. Resetting your password also revokes every active session by design.

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: August 24, 2026