How to Edit the Mac Dictionary: Add & Remove Words
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)
- Open any app where you can type text, like TextEdit, Notes, or Safari.
- 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.
- From the context menu, select Learn Spelling. The word is added to your user dictionary immediately.
- 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
- Click the Apple menu and select System Settings (or System Preferences on older macOS).
- Click Keyboard, then select the Text tab (or the “Text” section).
- Scroll down to the Spelling section. You’ll see a list of words that macOS has learned (this is your user dictionary).
- Click the + button at the bottom of the list.
- Type the word you want to add, then press Return. The word is now in your dictionary.
- To remove a word, select it in the list and click the – button.
Method 3: Manually Edit the User Dictionary File (Advanced)
- Open Finder and press Command+Shift+G (Go to Folder).
- Enter
~/Library/Spelling/and press Return. (The tilde ~ refers to your home folder.) - You’ll see a file named
LocalDictionary(no extension). This is a plain-text file that contains one word per line. - Open it with TextEdit (right-click > Open With > TextEdit). If TextEdit isn’t in the list, choose “Other…” and navigate to Applications > TextEdit.
- Add each word on its own line, or delete lines to remove words. Save the file (Command+S).
- Close and reopen any apps that use spell-check for the changes to take effect.
Method 4: Edit the System Dictionary (Not Recommended)
- Open Finder and press Command+Shift+G.
- Enter
/Library/Dictionaries/and press Return. - 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. - 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
.dicfile 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.