All systems operational View status page

Starting your first dictation

Available on: Mac, Windows, iOS, Android

Writing an email, a Slack message, or a doc? Hold your hotkey, speak, and release — you'll be dictating in under a minute.


How to start dictating

Mac and Windows

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

  2. Press and hold the default hotkey — Fn on Mac, Ctrl + Win on Windows. Start speaking when you hear a ping or see the white bars moving.

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

  4. Release the hotkey. If your formatted text appears in the field, your first dictation is complete.

Note: On Macs without an Fn key, Flow assigns Ctrl + Opt during setup; hands-free becomes Ctrl + Opt + Space and Command Mode Cmd + Ctrl + Opt. Change hotkeys in Settings → General → Shortcuts. The start ping plays only if Sound Effects are on in Settings → System → Sound.

Tip: Press Esc or click cancel while dictating to cancel immediately, then start a new dictation right away.

iOS

  1. Open the Wispr Flow app, sign in if prompted, and complete the onboarding tutorial — you'll practice dictating during guided setup.

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

  3. Tap the microphone button, then tap Allow if prompted for microphone access.

  4. Speak at a steady pace.

  5. Tap the check button. Your formatted text appears in the text field.

Note: The Flow keyboard requires Full Access. If it isn't enabled, an Enable Full Access modal opens iOS Settings via Finish Setup. Dictation start/stop sounds are controlled by Settings → Audio → Interaction Sounds (default ON). In-keyboard cards start appearing after 3 successful dictations.

Tip: Tap the style pill on the keyboard to switch writing styles temporarily, or manage your default in the Styles tab. Select a flagged word after dictation for an Add to Dictionary option. Tap cancel to stop without inserting text. The keyboard's expandable menu holds an optional 'ABC' QWERTY toggle, an upgrade button ('Get Pro', or 'Claim Student Plan' for eligible students) or a refer-a-friend icon on paid team/business plans, a gear button that opens the main Flow app, and — while recording — a turn-off switch that stops recording and closes the menu. Swipe down on the notification area to collapse the menu.

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, granting microphone, accessibility service, and display over other apps permissions when prompted.

  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, speak, then tap the checkmark.

    2. Hold-to-Dictate: Press and hold the bubble, speak, and release when done. A cancel option appears after a few seconds.

  4. Wait briefly while Flow transcribes and inserts your text. If insertion fails, tap Paste on the bubble to paste from the clipboard.

Note: The bubble turns grey when your device is offline, meaning dictation is unavailable. A failed transcription shows "Failed to transcribe. Saved in the app." and the bubble switches to Retry — tap the Wispr icon to start a new dictation. If connectivity drops during a long session, you'll see "Taking longer than usual. Your audio is saved in the app." If insertion fails, the bubble switches to Paste; your clipboard text is preserved, and tapping the Wispr icon dismisses it. Android dictation start/stop sounds cannot be disabled.

Tip: Drag the Flow Bubble anywhere on screen — it snaps to the left or right edge. Drag it to the snooze circle at the bottom (shown only while the bubble is Ready) to hide it for 10 minutes. End snooze early by shaking your phone or tapping End snooze now on the Home screen.


FAQs

How do I use hands-free dictation?

Press Fn + Space (Mac) or Ctrl + Win + Space (Windows) to start, speak without holding any key, then press the same shortcut again to stop and paste.

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

Yes, on Mac and Windows. In Settings → General → Shortcuts, assign Middle Click, Mouse 4–10, or Aux Button, optionally combined with a keyboard key (e.g., Ctrl + Mouse 4). Left and right click cannot be used.

How many shortcuts can I assign per action?

Up to 4 shortcuts per action, each up to 3 keys (keyboard keys and/or mouse buttons). Cancel/Dismiss allows one shortcut only. Optional actions (Open Scratchpad, Note, Paste Last Text) start unset and their last binding can be removed entirely.

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 speak. 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?

Flow tracks which text field you clicked into when you started dictating and inserts your text there in supported apps.

Can I dictate with the iPhone Action Button?

Assign the built-in "Quick Dictation to Clipboard" shortcut in Settings → Action Button to dictate without opening an app first. Dictating outside a text field copies your transcript to the clipboard — open any app and paste. A "Quick Dictation to Notes" shortcut in the Shortcuts app saves your dictation to Flow Notes instead.

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

Your previous dictation — or a retry triggered from history — is still processing, and Flow won't start a new session until it finishes. Dismiss the notification, then press your shortcut again. Cancel only dismisses the notification; to cancel the in-progress transcription, follow the shortcut prompt in the notification body.

What are Smart Formatting and Backtrack?

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

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

Is there a time limit for dictation?

Mac and Windows: 20 minutes per session, with a warning under a minute before the end. At the limit, Flow ends the session with a "Transcription session ended" notification and a Recover text button. iOS: 5 minutes. Android: long sessions may end automatically.

Where do my past dictations go?

Past transcripts appear in Recent activity. Cancelled desktop sessions are saved there as audio only when they ran long enough; very short cancellations are discarded, and Enterprise accounts configured not to store dictation history save nothing.

What error messages might I see during iOS onboarding?

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

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

  • "Poor connection! Tap the mic to try again" Check your internet connection, then tap the microphone button.

  • "Your mic is being used by another app. Close other apps and try again!" Close apps that may be using audio, then retry.

  • "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!" Tap the microphone button to retry.

What in-keyboard error messages might I see on iOS?

If a transcription attempt fails from the Flow keyboard, a modal appears with a Retry button. Possible messages:

  • Audio Engine Error: "Audio engine failed to start, Please try again!"

  • Transcription Error: An error occurred during transcription.

  • Network Error: "Please check your network connection and try again."

  • Microphone Error: "Please check if the microphone is being used by another application."

  • Processing Error: "Unknown error. Please try again."

  • Microphone Access Denied: Flow does not have permission to use your microphone.

If recording fails to start entirely, a full-screen audio-failure view appears with Dismiss and Retry buttons. The keyboard can also show a service-disruption banner mirrored from the main app. Tapping a Flow push notification can copy or retry a specific transcript before opening the app.

What happens if I reach my free-plan word limit on iOS?

The free iOS plan allows 1,000 words per week, with a 1,500-word hard cap enforced in two stages: a soft limit that re-prompts as usage grows, then a hard cap that blocks transcription. A modal may appear instead of transcription:

  • Flow Pro Trial Ended: "You're now limited to 1000 words per week" — with an upgrade CTA.

  • No Words Left: You've used your weekly allowance — with an upgrade CTA. Students see a "Claim Your Student Plan" option.

iOS users may also see a one-time 'trial granted' modal and a one-time 'bonus words' modal.

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 the session and shows one of these:

  • Microphone Permission Required (Mac): Tap Grant Permission.

  • Microphone access is disabled (Windows): Access is off in Windows privacy settings. Tap Open Settings.

  • No microphone detected: Tap Open Sound Settings to connect one or verify an input device is selected.

  • Selected microphone is unavailable: The microphone pinned in Flow is no longer connected. Tap Choose Microphone.

  • Microphone unavailable: Another app may be holding the mic, or the audio driver needs a reset. Try dictating again, or tap Troubleshoot.

  • Microphone error: Tap Troubleshoot.

If your microphone stops picking up audio mid-session:

  • No audio received (first occurrence): Has a Contact us button.

  • Microphone is not working (escalated): Shown if the problem recurs, with Select microphone and Contact us buttons.

  • Microphone disconnected: Shown if your microphone disconnects mid-session, with an Insert button.


Limitations and notes

  • Clipboard usage (Mac/Windows): Flow temporarily uses your clipboard to paste text, then restores your previous clipboard contents.

  • Manual paste fallback (Mac/Windows): If Flow can't paste automatically, a notification titled "Click a textbox and use [shortcut] to paste" appears, where [shortcut] is your paste-last-text binding (default Cmd + Ctrl + V on Mac, Shift + Alt + Z on Windows). Your dictated text is placed on the clipboard so you can paste it manually.

  • Cancelled dictations (Mac/Windows): Cancelling with Esc, the cancel button, or on error stops the dictation immediately — nothing is transcribed or pasted. See "Where do my past dictations go?" for what is saved.

  • Text insertion fallback (Android): If Flow can't insert text into the field, tap Paste on the bubble to paste from the clipboard — your dictation is never lost.

  • Screen timeout (iOS/Android): Your screen stays on while you dictate; normal timeout resumes afterward.

  • Mouse button triggers (Mac/Windows): An assigned mouse button no longer performs its default action in other apps (e.g., Mouse 4 won't trigger browser back). Some Logitech mice with Logi Options+ installed may not support Mouse 4/5 for push-to-talk, as the driver remaps them to trackpad gestures.

  • Writing styles (iOS): Your default style varies by app category (Personal, Work, Email, Other). The style pill temporarily overrides it, and overrides persist until you change the style. Available in English (US and British) only.

  • Keyboard layout (iOS): The Flow keyboard has no period or punctuation button on the bottom row; double-tapping space inserts a period, and double-tapping shift locks caps. On iPhone SE (2nd and 3rd generation), a globe (🌐) button switches keyboards on tap or opens the keyboard picker on long-press. The keyboard switches automatically to your other keyboard for numeric, phone, email, decimal, and numeric-ASCII fields.

  • Undo/redo during onboarding (iOS): Hidden on the keyboard throughout onboarding; they reappear once keyboard setup is complete.

  • Android permissions: Flow requires Microphone (to hear you), Accessibility Service (to insert text), and Display over other apps (to show the Flow Bubble). If any is missing, the Home screen shows an error card guiding you to enable it. Also allow Wispr Flow to ignore battery optimization to keep the bubble ready; non-Pixel devices may show additional manufacturer-specific prompts. After you enable the overlay or accessibility permission in system Settings, Flow detects it automatically and continues onboarding — no extra tap needed.

  • Flow Bubble visibility (Android): The bubble appears when the keyboard is open and hides when it's dismissed. It is hidden in banking and financial apps for security (shaking your phone won't bring it back while one is in the foreground) and in password, number, and phone-number fields. It may also be absent if the feature is unavailable in the current app, the 'display over other apps' permission is missing, it's snoozed, or the overlay failed to attach.

  • Bubble needs attention (Android): If Flow's Accessibility Service is revoked or stops responding, the bubble changes to a warning triangle (tap to re-grant accessibility permission) or a retry icon (tap to reconnect). Snooze is unavailable while Flow needs accessibility attention; if Flow needs attention while snoozed, the bubble reappears automatically.


Still need help?

Reach out to support — most issues are resolved in one reply. Contact us if:

  • Your dictation hotkey doesn't trigger anything, even after restarting Flow.

  • Flow shows an error notification not covered above.

  • Text transcribes but never appears in your text field, even after checking the clipboard.

Include your platform (Mac, Windows, iOS, or Android), Flow version, and what you've already tried.

Need a hand?

Reach the Flow team and we’ll help you get unblocked.