Spokenly logoSpokenly Docs

Word Replacements

Automatically swap words and phrases in your transcripts after recording.

Word Replacements apply after transcription, automatically swapping words and phrases in your transcripts. Navigate to General settings and click Word Replacements to add your rules.

On macOS you can also open it instantly from the menu bar icon, by pressing ⌘R while Spokenly is the active app, or with the spokenly://word-replacements deeplink.

To improve recognition accuracy, see Dictionary.

Word Replacements dialog

Each replacement has an Original field (what to find) and a Replacement field (what to substitute). Matching is case-insensitive and respects word boundaries.

Examples:

  • colourcolor (spelling normalization)
  • EricErick (name correction)
  • air podsAirPods (brand formatting)
  • gonnagoing to (informal speech)

Multiple Variants

You can list multiple variants separated by commas in the Original field. All of them will be matched and replaced.

Examples:

  • raycast, reycast, recastRaycast
  • cloud, claud, clodClaude
  • eleven labs, elevan labs, elaven labsElevenLabs

Regular Expressions (advanced)

Enable Use Regular Expression to match patterns instead of literal text. The Original field accepts standard regex syntax, and the Replacement field supports capture group references ($1, $2, etc.).

Examples:

  • \b(yea|yeah|ya)\byes (normalize informal variants)
  • \b(um|uh|er)\b → (empty) (remove filler words)
  • \b(ok|okay|Ok)\bOK (unify spelling variants)
  • (?-i)\bIT\bInformation Technology ((?-i) makes matching case-sensitive, replaces IT but not it)

Unlike plain replacements, regex patterns do not add word boundaries automatically. Wrap the pattern in \b to match whole words only, as in the examples above.

Timing (Before/After AI)

If you have modes with AI Instructions configured, each replacement shows a timing option:

TimingWhen it runs
Run Before AI InstructionsReplacement applied to raw transcript before AI processing
Run After AI InstructionsReplacement applied to AI output
BothRuns before and after AI processing

Use Before AI when you want the AI to see the corrected text. Use After AI for final formatting that shouldn't affect AI behavior.