How to Change Folder Icons on a Mac
Customizing folder icons on a Mac is one of those small tweaks that can make a surprisingly big difference — whether you're organizing a cluttered desktop, color-coding project folders, or just making your workspace feel more like yours. macOS makes this possible through a built-in method that requires no third-party software, though several tools exist if you want to go further.
How macOS Folder Icons Actually Work
Every folder on a Mac has an associated icon stored as part of the file's metadata — specifically in what macOS calls the resource fork. When you change a folder icon, you're replacing that stored image data with new visual information. macOS reads this at display time and renders whatever image you've assigned.
This is different from how some operating systems handle icons. macOS doesn't require a separate .ico file sitting in the folder. The icon data travels with the folder itself, which means customized icons generally survive being moved, copied, or shared — as long as the destination file system supports macOS extended attributes.
The Built-In Method: Copy and Paste via Get Info
This approach works on any Mac running a modern version of macOS, requires no downloads, and takes about 30 seconds once you know the steps.
What you need: An image file to use as your icon. PNG files with transparent backgrounds work best. Square images tend to look cleanest, especially at small display sizes.
Step-by-step:
- Open the image you want to use as an icon in Preview.
- Press Command + A to select all, then Command + C to copy it.
- Right-click the folder you want to customize and choose Get Info (or select the folder and press Command + I).
- In the Get Info window, click the small folder icon thumbnail in the top-left corner. A blue highlight will appear around it when it's selected.
- Press Command + V to paste your image.
The folder icon updates immediately. You'll see the change reflected on your desktop or in Finder right away.
To revert to the default icon: Open Get Info the same way, click the custom icon thumbnail in the top-left, and press the Delete key. macOS restores the original blue folder icon.
Using Icon Files (.icns Format)
If you're sourcing icons from icon packs or design resources, you may encounter .icns files — macOS's native icon format. These are multi-resolution icon files that store the same image at several sizes (16px through 1024px), so they render crisply at any scale.
To use an .icns file as a folder icon, you can't paste it directly. Instead:
- Open the
.icnsfile in Preview. - In Preview's sidebar, select the largest resolution version available.
- Copy it with Command + C.
- Paste into the Get Info window as described above.
This gives you the best visual quality, particularly on Retina displays where lower-resolution images can appear blurry.
Third-Party Tools for Bulk or Advanced Changes 🎨
The built-in method works well for individual folders, but becomes tedious if you're customizing dozens of folders. Several third-party utilities exist specifically for this purpose, offering features like:
- Batch icon assignment across multiple folders at once
- Drag-and-drop interfaces that simplify the process
- Built-in icon libraries so you're not sourcing your own images
- Color tagging integration alongside custom icons
These tools vary in complexity and approach. Some are lightweight menu bar apps; others are more fully featured icon management suites. Your macOS version matters here — tools built for older macOS versions may behave differently on recent releases like Sonoma or Sequoia, particularly given Apple's ongoing changes to system permissions and sandboxing.
Factors That Affect How This Works in Practice
Not every setup behaves identically. A few variables worth knowing:
| Factor | What It Affects |
|---|---|
| macOS version | Newer releases occasionally change permission behavior for icon writes |
| File system | Icons on APFS volumes behave differently than those on network drives or FAT32 |
| Folder location | System-protected folders (like Library) may resist icon changes |
| Image dimensions | Very wide or tall images may crop unexpectedly in the Get Info preview |
| Retina vs. standard display | Low-resolution source images look sharp on standard displays, blurry on Retina |
Network-mounted drives and cloud-synced folders (like iCloud Drive, Dropbox, or OneDrive) add another layer of complexity. Custom icons rely on macOS extended attributes, which some cloud services strip out during sync. A folder icon that looks correct on your Mac may appear as a standard blue folder on another machine or after a re-sync.
What Happens to Icons After macOS Updates
Major macOS updates don't typically wipe custom folder icons, but it's not unheard of for icons on the desktop or in system-adjacent locations to reset. Icons stored on standard user folders — Documents, Desktop items, project folders — generally survive updates intact.
If you've applied icons to folders in more sensitive locations, or if an update changes how Finder renders icon data, a reset is possible. Keeping a note of which folders you've customized makes re-applying icons faster if that happens.
The Part That Depends on You
The built-in method is reliable and free — but whether it's the right approach depends on how many folders you're managing, how often your setup changes, whether you're working across multiple machines, and how much visual consistency matters to your workflow. Someone customizing three project folders on a single Mac has a very different picture than someone maintaining a shared team drive across platforms. The technique is the same; the experience of using it isn't.