Guide
Teach your Mac's dictation the words it keeps getting wrong
Surnames, product names, acronyms and jargon come out as whatever common word sounds closest. Here is why, what macOS lets you do about it, and what a custom vocabulary actually changes.
The short answer
When dictation spells a name, a brand or a technical term wrong, the fix is a custom vocabulary: a list of your words, in your spelling, that the speech model is shown before it listens.
On a Mac, Apple's Voice Control includes a vocabulary list for people who use it, and dictation apps such as Voz have their own. In a Whisper-based app like Voz, the words you add are handed to the model before it listens, which makes it far more likely to spell them your way.
Why names and jargon come out wrong
A speech model does not hear letters. It hears sounds and picks the most likely written words for them, and "most likely" means most common in the text it learned from. A word it has seen a million times wins over one it has seen a hundred, even when the rare one is what you said.
That is why the failures are so predictable. Surnames come back as ordinary words ("Kowalczyk" as something like "cove all check"). Product names get split or respelled ("Supabase" as "super base", "Kubernetes" in a variety of spellings). Acronyms are guessed letter by letter or turned into a word. Drug names, legal terms of art, place names outside the English-speaking world and the internal codenames of your own company all fail the same way, because the model has a strong guess for every sound and no reason to prefer your spelling.
None of this is a sign of a bad microphone or an unclear voice. Speaking more slowly rarely helps, because the model heard you fine. It simply chose the common spelling.
What macOS offers
Keyboard Dictation is the one you start with the Dictation shortcut set in System Settings ▸ Keyboard. Its settings there cover turning it on, its shortcut and its language; if you are looking for a place to add your own words, that is not where it is.
Voice Control is a separate accessibility feature in System Settings ▸ Accessibility ▸ Voice Control. It is built for operating the whole Mac by voice — "click Done", "scroll down", "select previous word" — and it has a Vocabulary list where you can add custom words. If you rely on voice commands as well as dictation, that list is worth filling in. One thing to know before you switch it on: Voice Control listens continuously for commands, which is a different way of working from pressing a key to dictate. Its vocabulary belongs to Voice Control, so treat it as part of that way of working rather than as a fix for the shortcut-driven Dictation you may have been using.
Where Apple's Dictation processes your audio — on the Mac or on Apple's servers — depends on your Mac and language. When that happens, and when it does not is its own question.
How a custom vocabulary works in a Whisper app
Whisper, the open speech model that Voz and many current Mac dictation apps are built on, accepts what its authors call a prompt: a short piece of text the model treats as if it had already been said just before your audio. A model that has just "heard" Kowalczyk, Supabase, PgBouncer is much more willing to write those spellings when it hears something that sounds like them.
It is a nudge, not a find-and-replace. That has three practical consequences:
- It improves the odds; it does not guarantee. If a word sounds very like a common phrase, the common phrase can still win now and then, especially in a short clip with little context around it.
- It is not a substitution list. You cannot tell it "whenever I say X, type Y". It only makes your spellings more likely for sounds that already resemble them.
- Shorter lists work better. Whisper only reads a limited amount of prompt — on the order of a couple of hundred tokens, and an unusual name can take several tokens on its own. A list of every word you have ever used gets cut off, and the words that matter can be the ones dropped.
Setting it up in Voz, step by step
- Open Voz and go to Settings.
- Find the Custom vocabulary panel: "Add names, brands, or technical terms Voz might not know."
- Type one word or name and press Return. It becomes a small chip; click its × to remove it. Duplicates are ignored regardless of capitals.
- Add the words that actually come out wrong — not every word you use. Start with the five or ten that annoy you most.
- Dictate a sentence that uses them. Press your dictation shortcut to start, press it again to stop, and the text appears at your cursor.
The list is stored on your Mac and is passed to the model for everything Voz transcribes: live dictation, recorded meetings, and audio files you drop in. Nothing about it is uploaded, because Voz has no server to upload it to. It works whichever language you dictate in.
If you want to try it, Voz is $2.99 once, with no account and no subscription.
What to put in the list
- Names spelled the way you want them. People, companies, products, places. Use the exact capitals — "macOS", "iPhone", "PostgreSQL" — because the model tends to copy the form it was shown.
- Acronyms you say as letters, written the way they should appear: "HIPAA", "SOC 2", "CI/CD".
- Your field's jargon that ordinary text rarely contains: drug and procedure names, statutes, library and framework names, internal codenames.
- Not common words. The model already spells "meeting" correctly; adding it uses up room for no benefit.
When a word still comes out wrong, check how it is spelled in your list first. A typo in the list is faithfully reproduced in your text.
When a vocabulary list is not enough
Some errors are not vocabulary problems. Heavy background noise, a strong accent the model handles poorly, or very dense technical speech all push a small model past what a hint can fix. Voz bundles Whisper's base model, which is fast and small enough to ship inside a 146 MB download, and is measurably less accurate than Whisper's larger models. Apps that run a larger model — or a cloud service — will do better on hard audio, and that is a fair reason to choose one. Our Superwhisper comparison covers the trade honestly.
To be fair to Apple
Apple's Dictation is free, already on your Mac, and on Apple Silicon it handles ordinary sentences well. If your names and terms come out right, there is nothing here worth buying. A custom vocabulary only matters to people whose work is full of words the dictionary has never seen.
Questions people ask next
Can I add words to Mac Dictation itself?
The built-in place for custom words is Voice Control's vocabulary, which is part of a separate, always-listening accessibility feature. An app with its own vocabulary, like Voz, works with a keyboard shortcut instead.
How many words can I add in Voz?
There is no fixed cap in the app, but Whisper only reads a limited amount of prompt text, so a long list gets truncated. Keep it to the words that genuinely come out wrong.
Does the vocabulary work for meetings and files too?
Yes. The same list is passed to the model for dictation, meeting recordings and file transcription.
Does it work in languages other than English?
Yes. The prompt works in whatever language you are transcribing; write each word the way it is spelled in that language.
Is my word list sent anywhere?
No. It is stored in Voz's settings on your Mac and only ever given to the model running locally.