ThisCalculator

Everyday

How to Edit the Mac Dictionary: Add & Remove Words

Updated · Standard formula, shown below

This guide shows you how to add, edit, and remove words from the macOS dictionary, so spell-check and Look Up work the way you want. You’ll learn the built-in method (which is the safest) and how to manually edit the user dictionary file if you need more control. No special tools are required.

What You’ll Need

  • A Mac running macOS (any recent version works).
  • Administrator access (only if you want to edit the system-level dictionary; for the user dictionary, a standard account is fine).
  • TextEdit (or any plain-text editor) if you plan to manually edit the dictionary file.

Step-by-Step

Method 1: Add a Word via Right-Click (Easiest)

  1. Open any app where you can type text, like TextEdit, Notes, or Safari.
  2. Type the word you want to add (e.g., “cryptocurrency”) and right-click (or Control-click) on it. If the word is underlined in red, macOS knows it’s not in its dictionary.
  3. From the context menu, select Learn Spelling. The word is added to your user dictionary immediately.
  4. To undo this later, right-click the word again and choose Unlearn Spelling. This removes it from your user dictionary.

Method 2: Add a Word via System Settings

  1. Click the Apple menu and select System Settings (or System Preferences on older macOS).
  2. Click Keyboard, then select the Text tab (or the “Text” section).
  3. Scroll down to the Spelling section. You’ll see a list of words that macOS has learned (this is your user dictionary).
  4. Click the + button at the bottom of the list.
  5. Type the word you want to add, then press Return. The word is now in your dictionary.
  6. To remove a word, select it in the list and click the – button.

Method 3: Manually Edit the User Dictionary File (Advanced)

  1. Open Finder and press Command+Shift+G (Go to Folder).
  2. Enter ~/Library/Spelling/ and press Return. (The tilde ~ refers to your home folder.)
  3. You’ll see a file named LocalDictionary (no extension). This is a plain-text file that contains one word per line.
  4. Open it with TextEdit (right-click > Open With > TextEdit). If TextEdit isn’t in the list, choose “Other…” and navigate to Applications > TextEdit.
  5. Add each word on its own line, or delete lines to remove words. Save the file (Command+S).
  6. Close and reopen any apps that use spell-check for the changes to take effect.

Method 4: Edit the System Dictionary (Not Recommended)

  1. Open Finder and press Command+Shift+G.
  2. Enter /Library/Dictionaries/ and press Return.
  3. You’ll see files like Apple Dictionary.dictionary. These are binary files, not plain text, and editing them directly can break the dictionary or cause system instability.
  4. If you need to add many technical terms, it’s safer to use the user dictionary methods above. For a truly custom dictionary, consider creating your own .dic file and installing it via the Dictionary app’s preferences (but that’s beyond this guide).

Common Mistakes

  • Editing the wrong file: The user dictionary is ~/Library/Spelling/LocalDictionary, not the system files in /Library/Dictionaries. Editing the latter can corrupt your dictionary.
  • Forgetting to save: When editing the LocalDictionary file, if you don’t save (Command+S) before closing, your changes are lost.
  • Adding words with spaces or punctuation: The dictionary expects single words (no spaces). For phrases, use the right-click method—it handles them better.
  • Not restarting apps: Changes to the dictionary may not appear until you quit and reopen the app you’re using.

Tips

  • Use the right-click method for quick additions: It’s the fastest and least error-prone.
  • Back up your LocalDictionary file: Copy it to a safe place (like iCloud Drive) so you can restore it if you switch Macs or reinstall macOS.
  • Use the System Settings list to see all learned words: This is the easiest way to review and remove multiple words at once.
  • For technical terms, consider adding them to the user dictionary: This keeps your system dictionary clean and avoids conflicts.
  • If you use multiple languages: Each language has its own dictionary. Make sure you’re adding to the correct one (check the language selector in System Settings > Keyboard > Text).

Troubleshooting

  • Changes don’t take effect: Quit and reopen the app you’re testing in. If that doesn’t work, restart your Mac. The dictionary cache can be stubborn.
  • Can’t find the LocalDictionary file: Make sure you typed the path correctly in the Go to Folder dialog. It’s case-sensitive. Also, the file might not exist if you’ve never added a word—create it as a new file in that folder.
  • The word is still flagged as misspelled: Check that you added the word to the correct language dictionary. If you use multiple languages, macOS may be checking against a different one.
  • You accidentally deleted the LocalDictionary file: macOS will recreate it automatically when you add a new word. Your previously added words are lost, but the system dictionary is unaffected.
  • The right-click menu doesn’t show “Learn Spelling”: Make sure the app you’re using has spell-check enabled (usually in Edit > Spelling and Grammar > Check Spelling While Typing).

Frequently Asked Questions

How do I remove a word that I accidentally added?

Right-click the word and choose Unlearn Spelling, or go to System Settings > Keyboard > Text, select the word in the list, and click the minus button.

Can I add a phrase or a name with a space?

Yes, the right-click method usually works for phrases. If not, add the phrase as a text replacement in System Settings > Keyboard > Text > Text Replacements.

Will editing the dictionary affect other apps?

Yes, the user dictionary is shared across all apps that use macOS spell-check (Safari, Mail, Pages, etc.). Changes apply system-wide.

Is there a way to export my custom dictionary?

Yes, copy the ~/Library/Spelling/LocalDictionary file. You can import it on another Mac by placing it in the same location.

Why does macOS keep flagging a word I added?

Check that the word is spelled exactly as you want, and that you’re using the correct language dictionary. Also, some apps (like Microsoft Word) have their own spell-check dictionaries that are separate from macOS’s.

Can I edit the system dictionary to add words for all users?

Technically yes, but it’s not recommended because the system dictionary is a binary file and editing it can cause issues. For a multi-user setup, each user can add words to their own dictionary, or you can create a custom dictionary file and install it in /Library/Dictionaries.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.