What to do if the app doesn't start up after signing in and clicking "Open Wispr Flow"

Mac

Reinstalling resolves most Mac startup problems, including an app macOS reports as damaged or missing.

1. Quit Flow: right-click the Flow icon in the menu bar and select Quit.

2. Drag Wispr Flow from Finder → Applications to the Trash, then empty the Trash.

3. Download the latest Mac installer from wisprflow.ai/downloads.

4. Open the downloaded file and drag Wispr Flow into your Applications folder.

5. Open Wispr Flow from Applications and click Sign in via browser.

6. Complete sign-in in the browser; it returns you to Wispr Flow automatically. If the main interface appears, the issue is resolved.

Windows

Remove any existing Wispr Flow install, then run the latest installer.

1. Close Flow: right-click the Flow icon in your system tray and select Quit. If the app is stuck, right-click the Flow taskbar button and select Quit Wispr.

2. Open Start → Settings → Apps → Installed apps (Windows 11) or Start → Settings → Apps → Apps & features (Windows 10).

3. Uninstall any Wispr Flow entry: click the ⋯ menu (or right-click the entry), select Uninstall, and confirm.

4. Download the latest Windows installer from wisprflow.ai/downloads, run it, and follow the prompts.

5. Open Flow from the Start menu and click Sign in via browser.

6. Complete sign-in in the browser; it returns you to Wispr Flow automatically. If the main interface appears, the issue is resolved.

iOS

Update and force-quit first; reinstall if Flow still won't start.

1. Update Wispr Flow from the App Store.

2. Force-quit Flow: swipe up from the bottom of the screen and swipe the Flow card away.

3. Reopen Flow and complete sign-in. If Flow opens to the main interface, you're done.

4. Reinstall Flow if it still won't start: delete the app, install it again from the App Store, and sign in.

The Notes, Dictionary, Snippets, and Style tabs stay locked until your first dictation in another app, showing Try Flow first — Dictate in another app to access the rest of Flow.

Android

Update and force-stop first; reinstall from the Play Store if Flow still won't start.

1. Update Wispr Flow from the Play Store.

2. Force-stop Flow from Settings → Apps → Wispr Flow → Force stop.

3. Reopen Flow and complete sign-in. If Flow opens to the main interface, you're done.

4. Reinstall Flow if it still won't start: uninstall the app, install it again from the Play Store, and sign in.

If sign-in appears to hang on Android:

• Waiting for <Provider>: finish sign-in in your browser, then return to the app — coming back without finishing resets the screen.

• Couldn't open the sign-in page. Please try again. No browser could be opened on this device.

• Sign-in didn't finish. Please try again. Sign-in stalled; tap to retry.

• Finish signing in resume screen: appears if the app was closed mid-sign-in. Tap Try again (available for Google, Apple, and Microsoft) to restart sign-in.

Notes don't appear right after launch on desktop

Cloud sync stays paused until your local settings finish loading at launch, so notes can briefly appear missing. Restart Flow or wait for the next sync. On an enterprise/HIPAA-restricted account, sync can fail on a brand-new device until settings load from the server.

The Flow Bubble is missing but Flow is running on Android

Act on the recovery card the Flow home screen shows:

• Flow Bubble Disabled: tap Turn Back On.

• Keep Wispr Flow running: tap Allow to exempt Flow from battery optimization.

• Enable Flow bubble on screen: tap Go to Settings to grant Display over other apps permission.

• Bubble is snoozed: tap End snooze now, or shake your phone while inside a text box.

Flow also notifies you (or shows a toast if notifications are off) when the Bubble stops working. Wispr Flow needs attention — Re-enable accessibility for Wispr Flow to keep working means accessibility permission was revoked; tap it to open the in-app accessibility repair screen. Flow isn't responding — Tap to restart Wispr Flow means permission is granted but the service stopped responding; tap it to open Flow's home screen.

Android battery manager stops Flow in the background

The system battery manager can shut Flow down in the background. During onboarding, most devices show a Keep Flow running in the background screen with an Allow button; on Xiaomi, Redmi, and POCO devices it reads Keep Wispr Flow running in the background — Select No restrictions with an Open settings button.

1. Open Flow's settings and follow the device-specific battery and autostart prompts.

2. Restart Flow. If the Flow Bubble stays visible after you lock and unlock your phone, the issue is resolved.

Flow shows "Accessibility access is required" on Android

Enabling the Wispr Flow accessibility shortcut instead of the main service toggle shows "Oops, something isn't right — Accessibility access is required to insert your dictations". Keep the shortcut off and turn on the Use Wispr Flow service toggle instead.

Wispr Flow icon is missing from the Mac menu bar and the Fn shortcut stopped working

This happens when the app was quit — after a restart, a force-quit, or selecting Quit from the menu bar. Relaunching brings everything back.

1. Check the top-right corner of your screen, near the clock. If you see the icon, click it to open the main window and skip the remaining steps.

2. Open Finder → Applications and double-click Wispr Flow. The icon reappears in the menu bar shortly after.

3. Test the Fn shortcut: click into any text field, hold Fn, speak, then release. If your transcription pastes in, the issue is resolved.

Summoning the hub from the Flow bar doesn't bring it to the front on Mac

Click the Flow icon in the menu bar to bring the window forward.

Sign-in fails on a restricted network

If your organization restricts Wispr to approved networks, sign-in fails until you connect to an allowed network. Switch networks or contact your admin, then retry: on desktop, a Your network isn't allowed screen replaces the login page — click Retry. On iOS, tap Retry, then tap your sign-in method again. On Android, sign-in fails — try signing in again.

Sign-in error messages on iOS

Dismiss the alert and tap your sign-in method again to retry. Messages you may see:

• Incorrect email or password: wrong credentials.

• Connection error: a network problem.

• Error: a Google, Apple, or Microsoft sign-in that failed after returning from the browser.

• Captcha service unavailable — Try a different sign-in method: email sign-in can't load its captcha; use Google, Apple, Microsoft, or SSO instead.

Why does the desktop app open automatically when I visit a shared note?

If you previously chose Always open in Wispr Flow, the desktop app launches once per page load when you open a shared note while signed in. Dismiss the dialog to stay in the browser for that page session, or clear the preference in your Wispr Flow settings to turn off auto-open entirely.

Why doesn't the desktop app log in after I sign in via browser?

Keep the Flow desktop app open and in the foreground while you complete sign-in. If you clicked an older email link, Flow shows Sign-in link expired. Please click "Sign In" again. — start a fresh sign-in. If it still doesn't respond, close and reopen the app, click Sign in via browser again, and confirm you're on the latest version. See also Sign-in fails on a restricted network above.

Why does Flow show only the Wispr logo on iOS and won't load past it?

This can happen if you tapped the mic button on the Wispr keyboard inside another app and the handoff back to Wispr Flow didn't complete. Force-quit Flow and reopen it; no reinstall is needed.

Why does Flow show a blank white screen on startup?

A blank window has no automatic recovery screen. Quit and reopen Flow; if it recurs, follow the reinstallation steps for your platform above.

Can I sign in with Google, Apple, Microsoft, or SSO on the desktop app?

Yes. Clicking Sign in via browser opens the Wispr Flow login page, where you can sign in with Google, Apple, Microsoft, SSO, or email.

What does the "Flow hit a snag" error screen mean?

It appears on an unexpected crash: "Your data is safe and we're looking into the issue. Try again, or restart Flow if the issue persists." Click Restart Flow to recover. If crashes continue, click Contact us to open a pre-filled email to support@wisprflow.ai.

Why did Wispr Flow open automatically after I connected a connector?

After you connect a service like Notion or Google Calendar, the browser success page returns you to Wispr Flow's Connectors settings automatically. If it doesn't, click Open Wispr Flow on that page. Pages showing "Almost done" (incomplete permissions) or an error always require a manual click.

Will my features still work if I launch Flow without an internet connection?

Yes, if you were already signed in. Flow saves a local snapshot of your enabled features and restores them offline, then refreshes once your connection returns. Signing out or switching accounts clears the snapshot, so a new account never inherits another user's features.

What happens if my sign-in callback link is invalid or expired on Android?

The page shows "Unable to open Wispr Flow. Please try signing in again." and the button is not tappable. Return to the app and start sign-in again to get a fresh link. If Wispr Flow isn't installed when you tap Open Wispr Flow, the page sends you to the Wispr Flow downloads page.

Why does Flow start silently on Windows login instead of opening the main window?

With Launch at login enabled, Flow starts in the background so it doesn't interrupt your workflow. Click the Flow icon in your system tray to open the main window.