How to Use Transforms (Beta)
Last updated: June 5, 2026
Available on: Mac and Windows (rolling out gradually). Polish on iOS is also available with a 10-word minimum.
Transforms let you rewrite text with AI — change tone, restructure, polish, or run your own custom prompts. Select text anywhere, press a shortcut, and Flow rewrites it in place.
Default shortcuts
Polish: Opt+1 (Mac) / Win+Alt+1 (Windows).
Prompt Engineer: Opt+2 (Mac) / Win+Alt+2 (Windows).
View Diff: Opt+O (Mac) / Win+Alt+O (Windows).
Rebind View Diff in Settings → Keyboard shortcuts under Transform view changes. Rebind Polish and Prompt Engineer from each transform's card on the Transforms tab.
Note: Transform shortcuts don't register until you first visit the Transforms tab, click Try it out, or toggle Transforms on. This keeps international keyboard characters (ñ, ö, etc.) working normally before you opt in.
Set up Transforms
Open the Transforms tab in Flow.
Click Try it out to launch the guided demo.
Highlight the sample text in the demo email editor and press Opt+1 (Mac) or Win+Alt+1 (Windows) to run Polish.
Click Turn on Transforms to enable the feature.
The Turn on Transforms button only appears after you complete a successful demo transform. Once Transforms is on, the opt-in toggle at the top of the Transforms tab controls whether the feature is active. Turning it off grays out the rest of the settings and removes the Polish and View Diff shortcuts from your keyboard.
Configure a transform
You can have up to 9 transform slots. Slot 1 is fixed as Prompt Engineer; slots 2–9 are customizable. A + Create your own card appears whenever you have fewer than 9 slots configured. A separate Polish card at the top controls the base Polish behavior, with 5 default toggle rules and up to 5 custom instructions of 50 words each.
Click any transform card to open its configuration modal.
Set a name (required for custom prompts).
Write a prompt describing what the transform should do.
Assign a keyboard shortcut.
Add writing samples (optional — see the next section).
Warning: There are no Save or Cancel buttons. Changes auto-save, but a transform is only saved once both a prompt and a keyboard shortcut are set. Closing the modal with any required field missing silently discards your changes.
The auto-save indicator shows Saving… while typing, then Saved, then a Last saved Xs ago timestamp. Each modal also includes a Reset button that restores defaults for that specific transform. The Reset Defaults button on the main Transforms page resets all transform settings after a confirmation step.
Add writing samples
Writing samples teach a transform what your finished writing should sound like. They're scoped to each individual prompt.
Limit: up to 5 writing samples per prompt.
Length: each sample must be 50–500 words.
Renaming: renaming a prompt carries its samples over.
Deleting: deleting or resetting a prompt removes its samples. Default Polish samples are always preserved.
Scoping: only samples for the active prompt are sent. Samples tagged to other prompts aren't included.
Storage: samples sync between Mac and Windows but are not available on iOS. Under Privacy Mode, sample text content is not uploaded (metadata only). Under enterprise Zero Data Retention policies, samples are kept on-device.
Turn on auto-polish after dictation
Flow can automatically apply a transform to every dictation.
Click the chevron up icon (▲) in the Flow status bubble to open the dropdown.
Turn on Auto Apply After Dictation at the top of the dropdown.
Select Polish, Prompt Engineer, or any custom prompt you've saved.
Your selection persists across restarts. With the picker expanded (e.g. while hovering the status bubble), clicking the circle triggers the currently selected transform.
When a non-default transform is active, the status bubble shows the first two letters of the prompt name in uppercase (for example, SU for a prompt named "Summarize"). Otherwise it shows the polish wand icon. While a transform is processing, the status area shows Using Polish for the default, or Using {name} for custom prompts.
Note: If auto-polish fails or times out, Flow falls back to pasting the original unpolished dictation.
See what changed
After a transform, press Opt+O (Mac) or Win+Alt+O (Windows) to open the diff viewer. The diff viewer shows:
Inline diff: teal highlights for additions, strikethrough for removals.
Change count: a badge that reads "1 Change" or "N Changes".
Primary action: Accept edits, Configure Polish, or Undo, depending on context.
Icon buttons: Copy, Thumbs Up, Thumbs Down, and Retry.
Use transforms in Scratchpad
Inside the Scratchpad, transforms have their own bar at the bottom of the window — separate from the global keyboard shortcuts.
Suggestion chips: three AI-ranked chips at a time, chosen from a catalog of six — More concise, More professional, More casual, Turn to list, Turn to table, and Polish.
Refresh: the circular refresh icon next to the chips reshuffles the chip set.
Custom prompt: the free-text input (Follow up or ask a question) lets you write a one-off transform. Press Enter or click the up-arrow to apply.
Scope: transforms apply to highlighted text if any is selected, otherwise to the entire note.
Versioning: in the Version history dropdown, chip transforms appear as Transform; free-text custom-prompt transforms appear as Custom transform.
Images: images attached to the note are preserved across transforms.
Auto-refresh: editing the content automatically regenerates a fresh suggestion set.
The Scratchpad Version history dropdown shows every save labeled by source — Typed edits, Dictated, Transform, Custom transform, or Created — with relative timestamps, so you can step back to any prior version.
Notifications you might see
Hey, select text first!
Shown the first 3 times you trigger a Transform shortcut without selected text. The notification includes the exact shortcut you used. After 3 times, Flow shows a shorter Select text to apply a transform reminder instead.
Want to Transform this? Highlight and press [shortcut]
A post-dictation nudge shown to new Transforms users on dictations of at least 150 words. Appears at most 3 times total and at most once per day, only after your first day of onboarding, and only while you have used a transform 20 or fewer times.
Congrats, you did your first transform!
A one-time celebratory splash shown after your first transform outside the Flow app, with a Customize transforms button that opens settings.
Couldn't detect text in your text box
Shown when Flow can't read text from the focused field. Click into your text box and try again.
Flow can't paste right now. Text saved to clipboard
Shown when the transformed text can't be pasted into the active field. The result is on your clipboard so you can paste it manually.
Transform timed out / returned no text / cancelled
Status messages for an in-progress transform. For auto-polish runs, Flow falls back to pasting the original unpolished dictation.
{name} doesn't work while dictating
Shown if you trigger a transform shortcut mid-dictation.
{name} mode servers are busy
Shown when the transform backend is experiencing high demand.
Your text looks good!
Shown when a transform completes but produces no changes.
We polished your dictation (with Reveal edit)
Shown when Flow silently auto-polishes a recent dictation in the background. Tap Reveal edit to see what changed.
Oops, too long to polish — Try again with under 1000 words
Transforms have a 1000-word input limit. Short text below the minimum is silently skipped — there is no "too short" notification.
FAQs
Why don't I see the Transforms tab in Flow?
Transforms is rolling out gradually on Mac and Windows. If you don't see the Transforms tab yet, your account hasn't received the rollout — there's no manual opt-in, and access expands over time.
Is Polish available on iOS?
Yes, Polish on iOS is available and rolling out gradually, with a 10-word minimum. Writing samples and the Translate to English re-polish option are not available on iOS — both are Mac and Windows only.
My Opt+1 or Opt+O shortcut isn't doing anything. Why?
Check these in order:
Confirm the Transforms opt-in toggle is on at the top of the Transforms tab.
Activate Transforms by visiting the Transforms tab, clicking Try it out, or toggling Transforms on. Shortcuts don't register until then.
Highlight text before pressing the shortcut — transforms need a selection.
What's the maximum text length for a transform?
1000 words on desktop. On iOS, Polish requires between 10 and 1000 words.
Are images in my Scratchpad note lost after a transform?
No. Images are preserved across transforms.
Can I get back to my original text after a transform?
In Scratchpad, the Version history dropdown lets you step back to any earlier save. Outside Scratchpad, the diff viewer's Undo button reverts the most recent transform.
Why didn't my new transform save?
A transform is only saved when both a prompt and a keyboard shortcut are configured. For custom prompts, a name is also required. If any of these is missing when you close the modal, the changes are discarded.
Do my custom transforms sync across devices?
Custom transform prompt slots don't sync across devices — they're stored locally on each Mac or Windows device. Your base Polish on/off settings and toggles do sync. Writing samples sync between Mac and Windows but are not available on iOS.
Why are my international keyboard characters (ñ, ö) not working?
Once you activate Transforms, the Opt+key shortcuts are reserved for transforms. To get those characters back, either turn the Transforms opt-in toggle off (which removes the shortcuts) or rebind the Transform shortcuts to a different combination in Settings → Keyboard shortcuts.
Limitations and notes
Transforms is rolling out gradually on Mac and Windows. Polish on iOS is also rolling out gradually with a 10-word minimum.
Up to 9 transform slots; slot 1 is fixed as Prompt Engineer.
Desktop accepts 1–1000 words per transform (exactly 1000 is allowed; 1001+ triggers the "too long" error). iOS Polish requires 10–1000 words.
Up to 5 writing samples per prompt, each 50–500 words.
Writing samples sync between Mac and Windows but are not available on iOS. The Translate to English re-polish option is also Mac and Windows only.
Custom transform prompt slots don't sync across devices. Base Polish settings do sync.
Transform shortcuts only register after you visit the Transforms tab, click Try it out, or toggle Transforms on. Until then, Opt+key combos work normally for international characters.
Transform chips and the Transform bar are only available inside the Scratchpad — elsewhere in the app, use the global keyboard shortcuts.
Short inputs are silently skipped — there is no "too short to transform" notification.
Still stuck?
Reach out to support if:
Your shortcuts still don't work after confirming the opt-in toggle is on and you've activated Transforms.
You see a transform error not listed in the Notifications section above.
Auto-polish consistently times out or returns no text on dictations under 1000 words.
Include your platform (Mac or Windows), Flow version, and the exact shortcut or transform name involved. Visit wisprflow.ai/support to get in touch with our team.