Word Replacements
Automatically replace recurring mishears, shortcuts, and phrases.
What Word Replacements Do
Word Replacements change matching text after you dictate. Each entry has one or more originals and one replacement.
Use them to:
- Correct a recurring mishearing, such as
voice ink→VoiceInk. - Expand a spoken shortcut, such as
my website→https://tryvoiceink.com. - Insert an address, signature, or other text you use often.
- Standardize a command, name, or product spelling.
Unlike Vocabulary, a Word Replacement applies the change directly and consistently.
Add a Replacement
- Open Dictionary.
- Select Word Replacements.
- Enter what VoiceInk usually writes under Original text.
- Enter what you want instead under Replacement text.
- Press Return or click the plus button.
You can map several originals to the same result by separating them with commas:
Voicing, Voice ink, Voiceing → VoiceInk
When the replacement text is exactly the same as an existing entry, VoiceInk keeps the originals together in one row. Replacement text remains case-sensitive, so VoiceInk and voiceink are treated as different results.
How Matching Behaves
Matching is case-insensitive, so an original such as voice ink can also match Voice Ink. VoiceInk avoids replacing the same letters inside a longer word in languages that use spaces.
If you create both a phrase and a shorter word that could match it, the more specific phrase is considered first.
Keep replacements narrow and predictable. A rule such as GitHub → GitHub Enterprise is usually unsafe because those names refer to different products, not a recurring transcription error.
Edit, Sort, and Remove
Use the edit button to change an entry and the remove button to delete it. Click the current sort label to cycle through:
- Original A–Z
- Original Z–A
- Replacement A–Z
- Replacement Z–A
- Newest
- Oldest
VoiceInk remembers your sorting choice.
Quick Add
Open Dictionary, click the gear button, and assign Quick Add to Dictionary a keyboard shortcut. The shortcut opens a small panel where you can add Vocabulary or a Word Replacement without opening the main VoiceInk window.
Auto Learn
Dictionary Auto Learn suggests replacements from your dictation corrections using local rules or optional AI review. Local review defaults to one correction; AI review can run automatically or on demand. Automatic suggestions require Add Correction; Manual AI review saves approved replacements when you click Review. Saved replacements remain fully editable.
Related
Import and Export
Word Replacements can be exported together with Vocabulary from Dictionary → gear → Dictionary Data. See Import and Export Dictionary for Merge and Replace behavior.