When an application crashes on a Mac, or an update fails to install correctly, the operating system can become confused. One of the most common symptoms of this confusion is missing or incorrect application icons in the Finder, Dock, or Launchpad. You might see a generic white sheet of paper instead of the familiar Safari compass or Microsoft Word logo.
This happens because the Launch Services Database—the internal index macOS uses to map file types and applications to their correct visual icons—has become corrupted.
In this guide, you will learn how to use a single Terminal command to force macOS to completely rebuild the Launch Services database, restoring all your missing app icons to normal.
What is the Launch Services Database?
Launch Services is a core framework in macOS. It is responsible for knowing exactly what application should open when you double-click a file (e.g., knowing that a .pdf should open in Preview). It also provides the Finder with the correct high-resolution icons to display for every file and application on your hard drive.
When this database corrupts, the links break. Rebuilding the database forces macOS to scan every application currently installed on your Mac and rewrite the index from scratch.
Step 1: Open the macOS Terminal
This repair process requires the use of the command line.
- Press Command + Space to open Spotlight Search.
- Type Terminal and press Enter to launch the application.
Step 2: Run the Rebuild Command
The command to rebuild the database is quite long, as it must point to a deeply buried system utility.
- Copy the entire command below exactly as written:
/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -kill -r -domain local -domain system -domain user - Paste it into your Terminal window.
- Press the Return key on your keyboard.
The terminal will appear to freeze for several minutes. This is completely normal. The lsregister utility is silently scanning thousands of files across your entire hard drive. Do not close the Terminal window.
When the process is finished, a new, blank command prompt line will appear.
Step 3: Restart the Dock and Finder
Although the database has been rebuilt, the Finder and the Dock might still be displaying the old, cached icons. You need to force them to refresh.
Type the following command into the Terminal and press Return:
killall DockYour screen will flash briefly as the Dock disappears and instantly reappears.
Next, type this command and press Return:
killall FinderAny open Finder windows will close, and the desktop icons will flash as the Finder restarts.
Finally, open your Applications folder or Launchpad. The generic white icons should be gone, replaced by the correct, high-resolution application graphics.