How to Rebuild the Desktop Database in Mac OS 9

This guide explains how to rebuild the Desktop Database in Mac OS 9 to resolve issues with missing, incorrect, or generic blank file icons. Over time, the internal index that links files to their parent applications can become bloated or corrupted, leading to display glitches and slower system performance. Following the straightforward steps below will safely purge the old cache and reconstruct a clean database without affecting your personal documents.

Why File Icons Turn Generic in Mac OS 9

Mac OS 9 relies on two hidden files at the root of each volume—Desktop DB and Desktop DF—collectively known as the Desktop Database. These files store application bundle information, icon graphics, and file associations (Creator and Type codes). When these files become corrupted or overfilled, the Finder fails to match documents with their respective programs, displaying a generic blank page icon instead of the proper application-specific artwork. Rebuilding the database forces the Finder to rescan your disks and refresh all icon associations.

Method 1: The Standard Startup Shortcut

The most common and effective way to rebuild the Desktop Database is by using a keyboard shortcut during the boot process:

  1. Save any open documents and go to the Special menu in the Finder, then select Restart.
  2. Immediately press and hold down the Command (⌘) and Option keys on your keyboard.
  3. Keep holding both keys until the Mac finishes loading system extensions and displays an alert box asking:
    "Are you sure you want to rebuild the desktop file on the disk '[Disk Name]'? Comments in info windows will not be saved."
  4. Click OK.
  5. If your system has multiple partitions, hard drives, or removable media mounted, the Finder will present this dialog box for each volume in sequence. Click OK for each drive you want to refresh.
  6. Allow the progress bar to complete. Once finished, the desktop will load normally with icons restored.

Method 2: Clean Rebuild (Without Extensions)

If system extensions or third-party startup items conflict with the standard rebuild process, perform a clean rebuild by combining safe booting with the rebuild shortcut:

  1. Restart your Macintosh.
  2. Hold down the Shift key as soon as the boot chime sounds to disable all extensions.
  3. Once the screen displays the message "Extensions Disabled", release the Shift key and immediately press and hold Command (⌘) and Option.
  4. When the confirmation prompt appears, click OK to rebuild the database.
  5. Once complete, restart the computer normally from the Special menu to re-enable your extensions.

Additional Tips for Stubborn Icons

  • Rebuilding Specific Drives: If an external drive or secondary partition is the only volume showing incorrect icons, unmount the drive, hold Command (⌘) and Option, and reinsert or remount the drive. The rebuild prompt will appear specifically for that volume.
  • Open the Application: If a specific document still displays a generic icon after rebuilding, launch the parent application directly and open the file through the File > Open dialog. Once saved again, the Desktop Database will recognize the link and display the correct icon.