How to Rebuild the Icon Cache on a Mac

In short: When app icons show up blank, generic, or stuck on an old version, macOS is usually serving a stale icon cache. This guide walks through the safe fixes in order, from a simple restart to a targeted Terminal reset, so you can get correct icons back without touching anything risky.

You open your Applications folder and something looks off. An app that used to have a crisp, colorful icon now shows a plain white sheet, a generic app placeholder, or the wrong artwork entirely. Nothing is broken, and the app still launches fine. What you are seeing is a stale icon cache on your Mac, and it is one of the easier cosmetic glitches to fix.

macOS keeps a database of the icons it has already drawn so it does not have to re-render them every time. That cache usually stays in sync, but after a big update, a botched app install, or a Time Machine restore, an entry can go stale. The icon on disk is correct, but the copy macOS is showing is out of date. Below are the fixes to try in order, starting with the calmest.

Try the simple fixes first

Before you open Terminal, rule out the changes that fix this without any commands. A surprising number of icon glitches clear on their own once macOS gets a chance to redraw.

• Restart the Mac. Choose the Apple menu, then Restart. A clean restart rebuilds a lot of runtime state and often refreshes icons on its own.
• Relaunch the Finder. Hold Option and right-click the Finder icon in the Dock, then choose Relaunch. This redraws Finder windows and the Desktop without a full reboot.
• Toggle the icon size. In a Finder window set to icon view, press Command plus J and drag the icon-size slider. Forcing a redraw sometimes shakes a single stuck icon loose.

If a specific app is the only one affected, quit it and reopen it, or drag it to the Trash and reinstall a fresh copy. When one icon misbehaves, the app package is often the culprit rather than the system cache.

Rebuild the icon cache from Terminal

If the simple steps did not help, you can clear the cached icon data directly. Open Terminal from Applications, then Utilities. These commands clear the cache and ask the icon services to rebuild it from scratch. You will be prompted for your password, and nothing appears when you type it, which is normal.

First, clear the icon services cache:

sudo find /private/var/folders/ -name com.apple.dock.iconcache -delete

Then clear the related Launch Services and generic icon caches, and restart the interface:

sudo rm -rf /Library/Caches/com.apple.iconservices.store

killall Dock

killall Finder

The killall commands simply quit and relaunch the Dock and Finder so they rebuild their icons. Your open apps and documents are not affected. After they relaunch, macOS regenerates the icon cache automatically the next time it needs to draw each icon, so give it a minute and the correct artwork should return.

Reset Launch Services when icons stay wrong

If icons are still generic, especially for documents opening in the wrong app, the Launch Services database that maps file types to apps may be confused. You can rebuild it with a single command:

/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user

This re-scans your apps and refreshes the type-to-app associations, which also nudges the icon cache. Run it, then restart your Mac so everything reloads cleanly. Do not delete anything by hand inside /System; the command above only rebuilds a database and is the supported way to do this.

A quick note on safety and reversibility

Clearing an icon cache is low risk because these files are disposable by design. macOS treats them as scratch data and rebuilds them on demand, so removing them does not touch your apps, documents, or settings. Even so, the same principle that keeps any cleanup safe applies here: prefer changes you can undo. If you ever clear caches with a cleaner app rather than Terminal, make sure its removals go to the Trash so they are reversible, instead of being permanently deleted. A stray file you can pull back out of the Trash is a problem you can fix in seconds.

That reversibility mindset is worth extending to how you pick tools in general. A cleaner reading your caches has no reason to send anything off your machine, and you can confirm that yourself with a firewall like Little Snitch, which shows you exactly what an app tries to connect to.

If you would rather use a cleaner

Doing this by hand is perfectly fine, but if you clean caches often and want a tool that previews everything first and only sends removals to the Trash, a couple are worth a look. CoreSweep is our top free pick. It is free forever with an optional one-time Pro upgrade ($49, no subscription), it does zero telemetry, and every deletion is reversible through the Trash. As a strong runner-up on value, SkoonMac is also free, with a one-time Pro at just $19. Either one lets you review exactly what will be removed before anything happens, which is the habit that keeps cleaning safe.

In most cases, though, a stale icon is nothing more than a display hiccup. Start with a restart, work down to the Terminal steps only if you need them, and your icons should snap back to how they are supposed to look.

Frequently asked questions

Why do my Mac app icons look blank, generic, or wrong?

macOS keeps a cache of icons it has already drawn so it does not have to re-render them every time. After a big update, a bad app install, or a Time Machine restore, an entry can go stale, so the icon on disk is correct but the copy macOS shows is out of date. Nothing is broken and the app still launches fine; it is just a cosmetic display glitch.

Is it safe to clear the icon cache on a Mac?

Yes, it is low risk because these cache files are disposable by design. macOS treats them as scratch data and rebuilds them on demand, so removing them does not touch your apps, documents, or settings. If you use a cleaner app instead of Terminal, make sure its removals go to the Trash so they stay reversible.

Can I fix a stuck Mac icon without using Terminal?

Often yes. Try restarting the Mac, relaunching the Finder (Option and right-click the Finder in the Dock, then Relaunch), or toggling the icon size in a Finder icon-view window. If only one app is affected, quitting and reopening it, or reinstalling a fresh copy, usually fixes it without any commands.

← All Mac cleaning guides · Back to the comparison