Product updates

Mac dictation custom vocabulary: names, jargon and limits

Dylan de Heer, Co-Founder & CPO

Dylan de Heer

Mac dictation custom vocabulary: names, jargon and limits

On a Mac, custom vocabulary depends on the tool entering your text. Apple’s documented Vocabulary controls belong to Voice Control. Weeve has its own personal dictionary. Start by identifying the active dictation system, then add terms in that system and check the result in a short passage.

A saved spelling is useful context, but it is not a guarantee that every spoken word will be recognised correctly. It also does not mean that a word added in one app becomes available to every other dictation tool.

This guide explains those boundaries for names, company names and technical language. It does not rank recognition accuracy or claim that a particular dictionary will resolve every error.

First identify which dictation tool is listening

Three features can look similar when the result is text appearing in an email or document:

  • Keyboard Dictation: Apple’s standard Dictation feature, configured under Keyboard in System Settings.

  • Voice Control: Apple’s accessibility feature for controlling the Mac and entering text by voice, with its own Vocabulary controls.

  • Weeve dictation: Weeve’s voice-input workflow, with its own settings and personal dictionary.

A shortcut, microphone indicator or floating control can help you identify what started the session. Check the settings of that feature before changing a word list elsewhere.

Apple explains that when Voice Control is on, standard macOS Dictation is not available. This is why instructions for Voice Control should not be treated as a hidden Vocabulary menu for ordinary Keyboard Dictation.

If you cannot tell which system is active, stop the input and run one short test using a known feature. Avoid starting several voice-input tools at once while you are diagnosing a spelling problem.

What a custom vocabulary can change

A custom vocabulary supplies terms that the selected tool can use. The relevant detail may be an unusual product name, the preferred casing of a company name or a phrase used in your work.

There are different mechanisms behind features described as a “dictionary”:

  • A spelling list stores how a term should be written.

  • Pronunciation input, where the tool provides it, associates a term with spoken information.

  • A writing-style preference affects how a draft is phrased or presented.

  • A spellchecking dictionary helps an editor check already written text.

Do not assume these settings are interchangeable. A feature that changes sentence style does not necessarily resolve the spelling of a name, and accepting a word in a text editor does not establish that a speech tool has learned it.

A useful word list is specific. Include the spellings you actually need, then check whether they help in context. A large collection of vaguely related words can make it harder to understand which entry is responsible for an unexpected substitution.

Apple Voice Control: use its documented Vocabulary settings

Apple’s custom-vocabulary guide describes adding words and phrases to Voice Control for supported languages. It also describes importing and exporting lists.

In the current guide, the route is:

  1. Open System Settings → Accessibility → Voice Control.

  2. Open Vocabulary.

  3. Add the word or phrase using the spelling you want.

  4. Follow the pronunciation or save options shown by your version of macOS.

  5. Test the term while using Voice Control in the intended language.

Apple notes that a dimmed Vocabulary option means the selected language does not support a custom vocabulary. Check the guide and controls for your installed version; do not assume every Mac, language or version exposes identical options.

These steps configure Voice Control. If you return to another dictation app, check that app’s own vocabulary feature rather than assuming the list transfers with you.

For ordinary Keyboard Dictation, use Apple’s current Dictation instructions to check the active language, microphone and feature behaviour. A vocabulary problem and a language-selection problem can produce similar-looking wrong words while requiring different checks.


An open orange cloth card wallet holds three separate blank cream cloth slips.

Weeve: keep a small, deliberate personal dictionary

Weeve’s personal dictionary stores spellings you enter for use in its transcription and summary workflows. It is a separate feature from Apple’s settings and from Weeve’s speaking-style profile.

To add a term in the current Weeve interface:

  1. Open Settings → Dictionary. The Dictations page also provides Personal dictionary → Open dictionary.

  2. Enter the company name, product name or phrase using the spelling and casing you want.

  3. Press Enter to add it.

  4. Confirm the saved entry appears in the list.

  5. Dictate a short new passage and review the result before relying on the change.

When adding several entries, use one word or phrase per line. A phrase belongs together on one line. If a spelling needs changing, remove the entry and add the corrected spelling; the current list does not provide an in-place edit.

Keep the list relevant to your work. Adding a spelling supplies a candidate for controlled correction. It does not mean every similar-sounding everyday word should be replaced by that name.

Understand the short-word and correction limits

Weeve’s current Dictionary interface explains that entries shorter than four letters are used for summaries only. A short acronym can therefore be saved without becoming a transcript-correction rule. Review that acronym directly in dictated text rather than assuming the saved entry will force it into every passage.

The correction logic also guards against ambiguous matches and ordinary-word collisions. Those limits matter: a name can be correct in one sentence and an inappropriate replacement in another.

Your manually entered dictionary words remain separate from the Correct known names preference for inferred People and Project names. Turning that preference off does not remove the personal words you deliberately entered.

The broader Weeve dictation workflow explains voice input on the Mac. Adding words in Weeve does not configure Apple’s Voice Control vocabulary or Keyboard Dictation settings.

Keep vocabulary separate from speaking style

A name-spelling problem is different from wanting shorter sentences or a different tone.

Weeve’s speaking-style workflow lets you review an editable style summary for future dictation. Use that for wording preferences. Use Dictionary for the authored spellings you want the tool to consider.

If you change both at once, an improvement or regression becomes harder to explain. Start with the setting directly related to the problem, keep a small example and review the resulting text.

For instance, “use less formal phrasing” is a style preference. “Write this product name as OrbitDesk” is a spelling preference. Neither instruction proves that a phrase was captured correctly from the microphone.


One orange cloth tile leans towards a wide gap before three separate upright cream cloth tiles.

Test names in a sentence, not only in isolation

Choose a short, non-sensitive passage containing the term. Use the same feature, language and destination that you intend to use for real work.

Here is a fictional test passage:

Send the OrbitDesk notes to Velunara after the planning call.

OrbitDesk and Velunara are invented example spellings for this exercise. They are not a report of a successful recognition test.

Before changing the dictionary, note what the tool actually writes. Then add only the intended entry and repeat the passage. Check:

  • Whether the target term now has the intended spelling and casing.

  • Whether the surrounding words still match what you said.

  • Whether a different sentence containing an ordinary similar-sounding word remains correct.

  • Whether the text reached the intended field without an unexpected rewrite afterwards.

An improvement in one passage is a useful local observation, not a general accuracy benchmark. Keep reviewing important names, numbers and negatives in actual work.

If the tool offers a pronunciation recording, follow that tool’s instructions. Do not describe typing a spelling into Weeve’s dictionary as recording a pronunciation or training a personal acoustic model.

If the word is still wrong, check in this order

1. Check the active system and language

Confirm you changed the dictionary belonging to the feature that produced the text. Check the selected language or region where the tool exposes that setting.

If the result is wrong in many ordinary words, widening the vocabulary list may be the wrong next step. Return to a short baseline passage and check the input setup.

2. Check that the entry was saved as intended

Look for the entry in the list. Check spelling, casing and whether a phrase was split across multiple lines. If the interface reports a save problem, resolve that before treating the new word as active.

In Weeve, account for the short-word limit above. A saved entry and a matching correction opportunity are different conditions.

3. Separate a source problem from a vocabulary problem

Speak clearly at a normal pace and use a quiet test passage. If the microphone did not capture a word intelligibly, a dictionary cannot reliably recreate what was missing.

If dictation is failing to start or text reaches one app but not another, use the Mac dictation troubleshooting guide. Those are different symptoms from one consistently mis-spelled term.

4. Check for an unwanted substitution

If unrelated words change after an entry is added, remove the entry temporarily and repeat your short test. Keep the change reversible. Do not add more approximate spellings merely to force a result you have not checked.

Where the tool declines an ambiguous correction, edit the final text yourself. A cautious non-correction can be preferable to inserting the wrong person or company into a message.

When manual review is the right outcome

Some names, short acronyms and mixed-language phrases will still need checking. Keep a reliable reference for the spelling and compare it with the text before sending or sharing.

If you need help with a persistent problem, collect the product and version, active language, intended spelling, actual output and a short non-sensitive example. Explain whether the term is saved and whether the issue occurs in more than one destination. That gives support a repeatable description without sending a private conversation by default.

The aim is a useful, understandable vocabulary setup: the right list in the right tool, a small set of deliberate spellings and a review habit that catches both missed corrections and unwanted ones.