Set up the Flow keyboard on iPhone
Last updated: July 15, 2026
Available on: iOS
Add Wispr Flow as a keyboard on your iPhone to dictate directly into Messages, Mail, Slack, and any other app with a text field. Setup takes under a minute.
Quick checks
Is the Wispr Flow app installed? Install and open the app at least once before the keyboard appears in iOS Settings.
Are you signed in? Open the Wispr Flow app and confirm you're logged in — the keyboard won't work otherwise.
Are you online? The keyboard needs Wi-Fi or cellular data to transcribe. If you're offline, dictation will fail.
How to set it up
Open the Settings app on your iPhone.
Tap General → Keyboard → Keyboards.
Tap Add New Keyboard and select Wispr Flow.
Tap Wispr Flow in the keyboard list, then enable Allow Full Access and tap Allow in the popup.
Verify it works. Open any app with a text field, tap and hold the globe icon on the keyboard, select Wispr Flow, then tap the microphone button and dictate a short phrase. If text appears, you're all set.
Note: Full Access is required for transcription to work. Audio is handled securely and is not stored. The first time you start a recording, iOS will also ask for microphone permission — tap Allow to grant access.
FAQs
How do I switch to the Flow keyboard while typing?
Tap and hold the globe icon on any keyboard, then select Wispr Flow from the list.
Can I use the Flow keyboard in any app?
Yes. The Flow keyboard works in any app that uses standard iOS text input — Messages, Mail, Notes, Slack, and more. Some apps with custom text fields (like certain banking apps) may not support third-party keyboards.
Why does the system keyboard appear in some fields instead of Flow?
Flow automatically switches to the system keyboard for number pads, phone fields, decimal pads, email-address fields, and numbers-and-punctuation fields. This is expected behavior.
Does the Flow keyboard autocapitalize as I type?
Yes. The Flow QWERTY keyboard automatically capitalizes to match system keyboard behavior. Specifically, it capitalizes:
The first letter at the start of a new text field
The first letter after a sentence-ending punctuation mark (. ! ?) followed by a space
The first letter after a newline
The standalone pronoun "i" to "I", including common contractions like "i'm" → "I'm", "i'll" → "I'll", "i've" → "I've", and "i'd" → "I'd". Both curly ("smart") and straight apostrophes are supported.
The keyboard also respects the capitalization rules of the field you're typing in — for example, username and email fields suppress auto-capitalization, while word-by-word capitalization fields capitalize the first letter of each word.
If you tap Shift or enable Caps Lock manually, that setting stays active until you tap Shift again. The keyboard will not incorrectly capitalize letters when you're typing in the middle of a word. The "i" → "I" autocorrection is English only.
Autocorrect skips words that contain digits and acronyms (words with two or more uppercase letters). If you retype your original word after a correction, Flow will stop autocorrecting that word for the rest of the session.
Does double-tapping the space bar insert a period?
Yes — quickly tapping the space bar twice converts the space to ". " (a period followed by a space), matching stock iOS keyboard behavior. This only fires when:
Both taps happen in quick succession
You haven't moved the cursor between taps
There is no active text selection
The characters around the cursor are not already whitespace or punctuation
It will not trigger if you tap a single space next to an existing space while editing mid-text, or after a noticeable pause between taps.
Press and hold the space bar to enter cursor-move (trackpad) mode. While holding, slide your finger to move the cursor.
What is the "Show full QWERTY keyboard" setting?
When available, this toggle appears in Wispr Flow Settings → General. When on, the Flow keyboard includes a full QWERTY layout; when off, tapping the ABC key switches to your next system keyboard. This toggle isn't visible to all users yet.
How does fast multi-finger typing work on the Flow keyboard?
The Flow keyboard matches Apple's system keyboard for fast typing. When you press a second key while another finger is still down, the first key commits immediately — in the order you touched down, not the order you lifted off. This means letters always appear in the order you intended, even when typing quickly with multiple fingers.
Tap accuracy is also tuned so that taps in the small gaps between keys or near the edges snap to the nearest key, and taps aimed at the space bar reliably register as a space across all supported iPhone screen sizes.
Other typing behaviors are supported too: magnify callouts when holding a key, space-bar trackpad mode for moving the cursor, delete and return key autorepeat (with word-by-word deletion after a longer hold), and haptic feedback. When you hold Delete, characters delete one at a time, then switch to deleting whole words after a moment.
The microphone button does nothing when I tap it
Microphone permission hasn't been granted or was revoked. Open Settings → Privacy & Security → Microphone and enable the toggle next to Wispr Flow.
If Wispr Flow doesn't appear in the list, open the Wispr Flow app and tap the microphone once to trigger the iOS permission prompt. Keyboard extensions can't trigger iOS permission dialogs directly, so the prompt has to come from the main app.
If the microphone button doesn't respond after tapping, wait a moment — if the Wispr Flow app was closed in the background (common in Low Power Mode), the keyboard will automatically reset. Then tap the mic again to start dictating. Rapid repeated taps can delay the reset.
What do the error messages mean?
When dictation can't complete, an orange triangle warning icon appears next to the mic button. Tap the triangle to open a dropdown with details and options:
"Your text is saved but didn't make it through." The server was busy or the dictation was interrupted. Tap Retry to try again, or Dismiss to clear the warning.
"We didn't catch anything. Please try speaking again." Dictation failed due to a network issue — no internet, a lost connection, or a timeout. Check your Wi-Fi or mobile data, then tap Dismiss and try again.
"Poor connection! Tap the mic to try again." Dictation failed due to a network issue. Check your Wi-Fi or mobile data, then tap the microphone to retry.
"Your mic is being used by another app. Close other apps and try again!" Another app is currently using your microphone. Close other open apps, then tap the microphone again.
"Enable microphone access to use Flow." Microphone permission is not granted. Open Settings → Privacy & Security → Microphone and enable the toggle next to Wispr Flow.
"Oops, something went wrong. Tap the mic to try again!" An unexpected error occurred. Tap the retry icon or microphone button to try again.
For network errors, the triangle menu shows only Dismiss — you'll need to tap the mic to retry. For generic or cancelled errors, both Retry and Dismiss are shown.
Service incident indicator: If Wispr Flow is experiencing a service incident, you may see a red octagon (full outage) or yellow triangle (degraded) icon on the top bar. Tap it to see incident details and a link to our status page.
The keyboard shows "You're logged out"
Open the Wispr Flow app and sign in via the Log in button. The keyboard will work again once you're signed in.
The keyboard shows "No Network"
The keyboard needs an internet connection to transcribe. Reconnect Wi-Fi or cellular data and try again.
I don't see Keyboards or Microphone in Settings
Force close Settings and reopen it. The option will appear once the app has fully refreshed.
Why do I see a screen that says "Swipe back to your app"?
On iOS 26.4 and later, activating the microphone from the Flow keyboard may take you to the Wispr Flow app. Swipe right on the bottom bar to return to your previous app — dictation will continue as usual once you're back.
The first time this happens, you'll see a one-time alert titled "A quick change for iOS 26.4+" explaining the new manual-swipe requirement. Some users may still see the older automatic switch-back behavior.
Why is there a small gap above the keyboard's top bar on iOS 26?
If you're using iOS 26 with the Liquid Glass keyboard theme, you may see a small gap above the Flow top bar. iOS reserves this space for the Liquid Glass theme's safe area, and Flow can't remove it. It's expected on that theme and iOS version.
How do I remove the Flow keyboard?
Open Settings → General → Keyboard → Keyboards, swipe left on Wispr Flow, and tap Delete.
Common issues
Bugs fixed in recent updates
Several Flow keyboard issues have been fixed in recent versions. Update Wispr Flow from the App Store and restart your iPhone to get these fixes:
Tapping near the space bar typed 'm' or 'n' instead of a space: Taps aimed at the space bar that landed slightly above it could register as 'm' or 'n'. Space bar recognition has been improved, so taps near the space bar are less likely to register as m or n.
Letters appeared out of order when typing quickly with multiple fingers: When typing fast with more than one finger, keys could commit in the wrong order — based on when fingers lifted rather than when they touched down. Each key now commits in the order it was pressed, so your text always appears in the order you intended.
Taps near key edges or gaps between keys were missed: Tapping in the small gaps between keys or near the outer edges of the keyboard could fail to register. Taps in these areas now snap to the nearest key, so fast typing produces fewer missed keystrokes.
Double-space inserted a period while editing mid-text: Pressing a single space next to an existing space while editing could incorrectly insert ". " or even delete part of the previous word (for example, turning "word" into "wor. "). The double-space-to-period shortcut now only fires on a genuine consecutive double-tap of the space bar.
Autocorrect joined words together: Autocorrect could remove the space between words, turning "hello world" into "helloworld". Autocorrect now checks the current text before making changes and skips the correction if the text has changed, so words are no longer joined unexpectedly.
QWERTY keyboard didn't auto-capitalize correctly: The Flow QWERTY keyboard now capitalizes automatically in the same situations as the system keyboard — at the start of input, after sentence-ending punctuation (. ! ?) followed by a space, and after a newline. It also respects field-level capitalization rules (for example, no auto-capitalization in username or email fields), and no longer incorrectly capitalizes when typing mid-word. Manual Shift and Caps Lock remain sticky until you tap Shift again.
Flow returned to the wrong app after dictation: After finishing dictation, the keyboard could switch back to the wrong app. The keyboard now reliably returns you to the correct app you were typing in.
Standalone "i" not autocapitalized to "I" while typing: The Flow keyboard now automatically capitalizes the standalone pronoun "i" to "I" as you type, matching Apple's system keyboard. See the FAQ above for details.
Error UI redesigned — orange triangle with dropdown menu: Previously, transcription errors showed inline text labels ("Server is busy" or "Network error") alongside a separate retry button. Errors now show a single orange triangle warning icon next to the mic button. Tapping the triangle opens a dropdown with an explanation and action options (Dismiss and, where applicable, Retry).
Mic button briefly flashed a warning icon after an error: After an error, cancelled dictation, or network failure, the mic button could show a warning-triangle icon briefly before resetting. The mic button now stays visible immediately after any error, so you can start a new dictation right away.
"Audio was silent" warning no longer appears: When a dictation captured no speech, the keyboard used to show an "Audio was silent" warning. It now simply resets back to the microphone state, the same as after a successful dictation.
Network errors showed "Audio was silent" instead of a network message: If dictation failed because of a lost connection, timeout, or no internet, the keyboard incorrectly showed "Audio was silent." It now correctly shows a network error in the dropdown menu whenever the failure is network-related.
Network errors during onboarding weren't surfaced: If a network failure occurred during the initial setup flow, no error was shown. The keyboard now displays the same network error during onboarding.
Undo button stayed visible after moving the cursor: After dictating, moving the cursor to a different position in the text field could leave the undo button on screen — and tapping it did nothing. The undo button now dismisses immediately when you move the cursor. This applies to standard dictation undo only, not Voice Edit (which rewrites the whole field).
Keyboard got stuck on the mic button after returning from the Wispr Flow app: When the keyboard launched the Wispr Flow app to start recording and you switched back, the keyboard could get stuck showing the mic button with no waveform, and tapping it had no effect. The keyboard now resumes correctly after you return from the app.
Mic button showed no waveform after swiping back from the Wispr Flow app: After tapping the mic in the keyboard and being taken to the Wispr Flow app, swiping back could leave the keyboard showing the mic button with no waveform — and tapping it did nothing, even though dictation was running. The keyboard now correctly shows the waveform and remains responsive after switching back.
First dictation after launch failed or felt slow: Right after opening the app, tapping the mic could show an error and require a retry before the waveform appeared. The first dictation now starts reliably and quickly.
Mic button became unresponsive after canceling a dictation in Low Power Mode: If you canceled a dictation and the Wispr Flow app was closed in the background (common in Low Power Mode), the mic button could get stuck. The mic button now resets reliably in this case, so you can start a new dictation right away.
Flow keyboard felt stuck on iOS 26.4 — system keyboard appeared instead: In apps like Notion, Apple Notes, and Messages on iOS 26.4, the Flow keyboard could crash silently, causing iOS to show the system keyboard in its place. The keyboard now stays responsive across all apps on iOS 26.4.
Keyboard crashed when switching apps: The keyboard could crash the moment it appeared after switching from another app. It now recovers safely.
Mic button got stuck and caused duplicate text: After back-to-back dictations, the mic button could insert duplicate text. It now resets correctly between sessions.
Start Flow hand-off silently failed: The Start Flow button now reliably launches the main app and begins dictation on the first tap.
Action Button, Shortcuts, and widget dictation could fail: These entry points are now more reliable, especially when starting and stopping dictation quickly or after force-closing the app.
Dictation waveform got stuck and cancel button stopped working: After closing the main app mid-dictation, the keyboard now returns to its idle state automatically, and the cancel (✕) button always dismisses the dictation UI.
Dynamic Island microphone indicator stayed on after stopping dictation: Tapping the Turn Off toggle in the History view now fully stops the microphone session, and the Dynamic Island mic indicator clears promptly.
Tapping undo or redo after switching text fields could move text to the wrong place: The undo/redo button could remain active after switching to a different text field. Undo/redo now resets whenever you move to a new text field.
Undoing a dictation in rich text editors (like Apple Notes) could remove formatting: In apps that support rich text, using the undo button after dictating could strip out formatting such as bold titles or styled text. Undo now only removes the dictated text, leaving your document's formatting intact.
Undo/redo icon flipped before the text updated: The undo/redo button icon could visually flip a moment before the text in the document actually changed. The icon timing now matches the document update.
Undo button appeared when a safe undo wasn't possible: If the cursor or text had changed in a way that made undoing risky, the undo button now hides itself rather than potentially making an incorrect edit.
Undo/redo buttons stayed on screen after typing: Tapping any key (including backspace) on the Flow keyboard now reliably dismisses the undo/redo option.
Undo/redo buttons appeared during keyboard setup: The undo and redo buttons are now hidden throughout the entire keyboard setup flow. They reappear normally once setup is complete.
Keyboard showed "Start Flow" while recording: The keyboard now correctly detects when recording is active and updates its display.
Menu button disappeared after Select All + dictate: Selecting all text and then starting a dictation or Voice Edit session could hide the menu button. It now stays visible.
Raw code pasted instead of transcribed text in non-English languages: Formatted transcriptions in all languages now paste correctly.
White screen or stale content flashed when launching from the keyboard: The app now shows a clean loading screen, and the recording view only appears once everything is ready.
"We can't hear you" card appeared after onboarding: New users could see this card right after granting microphone permission. The first dictation now works immediately once permission is granted.
Keyboard battery drain: Background battery usage has been significantly reduced compared to earlier versions of the keyboard.
Setup tip text was cut off on smaller devices: The "Tap the mic to start speaking" tip shown during keyboard setup now scales down to fit on smaller iPhones (like iPhone SE) instead of being truncated.
Space bar showed "WisprFlow" instead of "Wispr Flow": The space bar on the Flow keyboard now correctly displays "Wispr Flow".
Check button color didn't match the mic button during dictation: While dictating, the confirm (✓) button now uses the same dark color as the mic button. Dark mode still shows both buttons in white.
Keyboard spacing looked off: The spacing between the Start Flow bar and the first key row, the gap above the home indicator, and the alignment of the top bar are now correctly laid out.
Visual polish for the top bar and notification drawer: The top bar (Start Flow button, microphone, style switcher, dictionary, Voice Edit button, notification bar) and the notification drawer icons have been refreshed for a cleaner, more consistent look.
Still stuck?
Reach out to support if:
Wispr Flow doesn't appear in the Add New Keyboard list after installing the app.
Allow Full Access is greyed out or won't enable.
Dictation still doesn't work after granting microphone permission.
Include your iPhone model, iOS version, and the app you were trying to dictate into. Most keyboard issues are resolved in one reply.