Starting your first dictation

Mac

Follow these steps to start your first dictation on Mac.

1. Click into any text field (Slack, Google Docs, Notion, etc.) so you see a flashing cursor.

2. Press and hold the Fn key (the default hotkey). When you hear a ping or see the white bars moving, start speaking.

3. Speak your message naturally at a steady pace. Flow listens while you hold the hotkey.

4. Release the hotkey when you're done. Flow pastes your formatted text into the text field. If the text appears, your first dictation is complete.

Windows

Follow these steps to start your first dictation on Windows.

1. Click into any text field (Slack, Google Docs, Notion, etc.) so you see a flashing cursor.

2. Press and hold Ctrl + Win (the default hotkey). When you hear a ping or see the white bars moving, start speaking.

3. Speak your message naturally at a steady pace. Flow listens while you hold the hotkey.

4. Release the hotkey when you're done. Flow pastes your formatted text into the text field. If the text appears, your first dictation is complete.

iOS

Follow these steps to start your first dictation on iPhone or iPad.

1. Open the Wispr Flow app and sign in if prompted.

2. Complete the onboarding tutorial if you haven't already — you'll practice dictating during the guided setup.

3. Tap into any note, document, or text field so you see the cursor.

4. Tap the microphone button. If prompted, tap Allow to grant microphone access. When Flow is ready, you'll see "Say something!"

5. Speak your message at a steady pace. Flow shows your words as it transcribes.

6. Tap the check button when done. Your formatted text appears in the text field.

Android

On Android, the Flow Bubble is a floating overlay that appears over all apps when you tap into a text field.

1. Open the Wispr Flow app and complete onboarding. Grant the required permissions when prompted: microphone, accessibility service, and display over other apps.

2. Tap into any text field in any app. The Flow Bubble appears on the edge of your screen.

3. Start dictating using one of two modes:

   1. Tap-to-Dictate: Tap the bubble once. The bubble expands to show Cancel (X), a waveform, and Done (checkmark) buttons. Speak your message, then tap the checkmark when finished.

   2. Hold-to-Dictate: Press and hold the bubble. Speak while holding — the bubble shows a waveform with a pulsing recording indicator. Release when done. A cancel option appears after a few seconds if you need to stop the transcription.

4. Wait briefly while Flow transcribes. Flow inserts your formatted text into the text field. If the text doesn't appear, check your clipboard — Flow copies it there automatically as a fallback.

How do I use hands-free dictation?

Mac: Press Fn + Space to start hands-free mode. Speak without holding any key. When done, press Fn to stop and paste.

Windows: Press Ctrl + Win + Space to start hands-free mode. Speak without holding any key. When done, press Ctrl + Win to stop and paste.

Can I open the scratchpad and dictate with one shortcut on Mac?

Yes. The scratchpad shortcut (default: Option + S) doubles as a dictation trigger once the scratchpad is open:

• Push-to-talk: Hold the shortcut for about a second. Speak while holding, then release to stop and transcribe.

• Hands-free: Double-tap the shortcut. Dictation continues until you tap the shortcut again to stop.

Customize this shortcut in Settings → General → Shortcuts.

Can I use a mouse button instead of the keyboard hotkey?

Yes, on Mac and Windows. Open Settings → General → Shortcuts and assign a mouse button as your trigger. Supported buttons include Middle Click, Mouse 4–Mouse 10, and Aux Button (some Logitech mice). You can also combine a keyboard key with a mouse button (e.g., Ctrl + Mouse 4). Left and right click cannot be used as triggers.

Can I start dictation from the Flow Bar?

Yes, on desktop. Click the Flow Bar in the center of your screen, wait for the ping or moving white bars, then start speaking. When you stop, Flow pastes your text into the active text field. If the Flow Bar isn't visible on a new installation, enable it in Settings.

Will my text always go into the right field?

Yes. Flow tracks which text field you clicked into when you started dictating and always inserts your text there — even in apps with several input fields on screen at once, like chat apps or Google Gemini.

What happens when I use the Action Button to dictate on iPhone?

If you assign the built-in "Quick Dictation to Clipboard" shortcut to your iPhone's Action Button (in Settings → Action Button), you can start dictating without opening any app first. When you dictate outside of a text field, your transcript is automatically copied to the clipboard — open any app and paste to use it.

A "Quick Dictation to Notes" shortcut is also available in the Shortcuts app, which saves your dictation to Flow Notes instead of the clipboard.

What error messages might I see during iOS onboarding?

During the "try it yourself" steps, if a dictation attempt doesn't succeed, a message appears at the top of the screen:

• "Oops, we didn't hear you.. Get closer to your mic!" Flow picked up silence. Move closer to your microphone and try again.

• "Poor connection! Tap the mic to try again" A network issue prevented transcription. Check your internet connection, then tap the microphone button to retry.

• "Your mic is being used by another app. Close other apps and try again!" Another app has exclusive control of your microphone. Close other apps that may be using audio, then try again.

• "Enable microphone access to use Flow" Go to your iPhone's Settings, find Wispr Flow, and enable Microphone access.

• "Oops, something went wrong.. Tap the mic to try again!" An unexpected error occurred. Tap the microphone button to try again.

Why do I see a "Flow was processing your last transcript" message?

This appears when your previous dictation is still being transcribed — or when a retry you triggered from Hub history is still processing. Flow won't start a new session until the current one finishes. Dismiss the notification, then press your shortcut again. You can also click Cancel in the notification to cancel the in-progress transcription.

What microphone error notifications might I see on Mac or Windows?

If Flow can't access your microphone when you start a session, it dismisses immediately and shows one of the following notifications:

• No microphone detected: No mic is connected or available. Tap Open Settings to check your audio devices.

• Selected microphone is unavailable: The specific microphone you had pinned in Flow is no longer connected. Tap Choose Microphone to select a different one.

• Microphone unavailable: Another app may be holding the mic, or the audio driver needs a reset. Tap Troubleshoot for guidance. This only appears if the problem happens twice within two minutes, since it often clears up on its own — try dictating again first.

• Microphone error: An unexpected problem occurred with the mic. Tap Troubleshoot for guidance. Like "Microphone unavailable," this only appears on a repeat failure within two minutes.

If your microphone stops picking up audio mid-session, the waveform goes flat after 5 seconds. At 15 seconds, a "Microphone is not working" notification appears with Select microphone and Contact us buttons.

What are Smart Formatting and Backtrack?

Smart Formatting automatically formats your dictation — say "first, second" to create a numbered list, or "new line" to insert a paragraph break.

Backtrack lets you change your mind mid-sentence and Flow adjusts what you just said.

What happens when I say "press enter"?

On desktop, saying "press enter" at the end of your dictation tells Flow to press the Enter key after your text is pasted. The words "press enter" are removed from the output.

The first time you use this command, a notification explains the feature (the Enter key is not pressed on that first use). Enable or disable it anytime under Settings → Experimental.

Is there a time limit for dictation?

Mac and Windows: Sessions automatically end after 20 minutes. A warning notification appears at 19 minutes with a Recover text button so you can retrieve what you said.

iOS: Sessions may have a time limit enforced by the system.

Android: Sessions have a 5-minute maximum. You'll see a warning at the 4-minute mark. At 5 minutes, the session ends and your text is submitted.

Why does my dictation output sound different in different apps on Android?

Flow automatically applies the writing style you've chosen for each app category. For example, dictating in a work app produces more formal output than dictating in a personal messaging app. Set your preferred style for each category in Personalization Styles in the Flow app.

Why do my activation instructions say "Double-tap" instead of "Hold"?

This is part of a redesigned onboarding experience. Double-tapping your hotkey starts hands-free dictation mode — dictation continues until you press your hotkey again to stop, rather than stopping when you release the key. You can double-tap to activate as many times as you like during onboarding.

Bugs fixed in recent updates

The following issues have been resolved in recent versions. If you're experiencing any of them, update Wispr Flow to the latest version and restart the app.

• Onboarding dictation failures gave no feedback (iOS): During the "try it yourself" steps in onboarding, failed dictation attempts would fail silently with no explanation. Flow now shows a message at the top of the screen explaining what went wrong and what to do next.

• Double-tap hands-free activation only worked once on the Gmail onboarding page: During the "Try It Yourself" step in onboarding, double-tapping the hotkey to start hands-free dictation could only be triggered once — subsequent attempts didn't activate. You can now double-tap to activate as many times as needed on that page.

• Dictation showed "Listening" even when the microphone couldn't be reached (Mac/Windows): When Flow failed to access the microphone at the start of a session, it would stay in a "Listening" state for up to 24 seconds before showing a generic "Transcript failed to load" error. Flow now dismisses the session immediately and shows a specific notification explaining the problem.

• Retrying a Hub history item could cancel an active recording (Mac/Windows): Clicking Retry on a history item while a dictation was in progress could interrupt and discard the active recording. Retry is now disabled during active dictation, and pressing the dictation hotkey while a retry is processing shows a "Transcript currently processing" message.

• Transcript dropped when ending dictation from the Dynamic Island (iOS): Ending a dictation session by tapping the Dynamic Island could cause the transcript to be lost. The transcript is now correctly saved to Flow Notes.

• Dictated text didn't insert correctly in Gmail on Samsung and some other apps (Android): In certain apps that use a WebView-based text field (such as Gmail on Samsung devices), dictated text could fail to appear or insert incorrectly. Fixed in version 1.5.0.

• Dictation limit notifications showed the wrong time (Mac/Windows): Warning and session-ended notifications incorrectly referenced a "6 minute limit" instead of the actual 20-minute limit. Notifications now correctly state the 20-minute maximum.

• Microphone stayed active after cancelling dictation (Android): Cancelling a dictation session could leave the microphone running in the background. Fixed.

• Submit button was clipped off-screen when switching dictation modes (Android): Switching between Hold-to-Dictate and Tap-to-Dictate could cause the Done (checkmark) button to be partially or fully hidden. The dictation bubble now fully resets between sessions.

• Keyboard appeared blank after tapping "Start Flow" (iOS): After tapping "Start Flow" to switch to a third-party app, the keyboard could appear blank or transparent until the device was rotated. Fixed.

• Background tasks interfered with active dictation sessions (Mac/Windows): Background tasks could occasionally run during an active session, causing slowdowns or interruptions. Background tasks are now automatically paused while you're dictating and resume once your session ends.

• App crashed when adding a duplicate word to the dictionary (Android): Adding a word that already existed in the dictionary could cause the app to crash. Fixed in Android version 1.4.0.

• App crashed when deleting a transcript on the Home Screen (Android): Deleting a transcript from the Home Screen could cause the app to crash. Fixed in Android version 1.4.0.

• App crashed during screen transitions (Android): Navigating between screens could occasionally cause the app to crash. Fixed in Android version 1.4.0.

• Words in transcriptions were sometimes misread (Android): An error in how speech recognition processed individual words could produce incorrect output. Fixed in Android version 1.4.0.

• Dictation activation delayed or missed during normal typing (Mac/Windows): Pressing the hotkey while typing could occasionally cause dictation to start several seconds late or not start at all. Keyboard shortcuts such as dictation activation, transform shortcuts (e.g., Opt+S), and paste last text were affected.

• Keyboard writing style didn't apply (iOS): Selecting a temporary writing style using the style pill on the keyboard sometimes had no effect on the dictation output.

• Hotkey took 30+ seconds to respond (Mac): Pressing the activation shortcut could cause a long delay before dictation started.

• Keyboard layout flashed (iOS): Tapping the mic button inside the Wispr Flow app briefly showed the keyboard layout before the waveform appeared.

• Dictation wouldn't start after cancelling a session: Cancelling a dictation session while it was still starting up could leave Flow in a stuck state.

• Text appeared in all lowercase (Windows): A capitalization bug during onboarding and in-app dictation caused all text to appear in lowercase.