Mac+ ↓ Download for macOS
Troubleshooting · macOS

Custom folder icon blurry on Mac? Here's why

You dropped a nice image onto a folder through Get Info, and the result looks soft, muddy or visibly pixelated — especially at large icon sizes in Finder. The instinct is to blame the image, so people go hunting for a bigger file and paste again, and it stays blurry. In most cases the image was never the problem: what landed on the clipboard was a 32-pixel icon, not your picture. Here's how to tell the two apart, plus the other five reasons a custom icon comes out soft.

By macOS developer, creator of Mac+

Updated 2026-08-02 · 6 min read

macOS desktop running Mac+: the Lava animated wallpaper, a calendar widget and a weekend countdown, and two folders with custom icons
Two custom folder icons rendered at full icon resolution — no clipboard round-trip.

The usual cause: you copied the icon, not the image

There are two completely different things you can copy from an image file on macOS, and they use almost the same gesture.

The wrong one: you select the image file in Finder, press ⌘ + I to open Get Info, click the small icon in the top-left corner and press ⌘C. That copies the file's icon representation — a thumbnail macOS generated for Finder, often 32 or 128 pixels. Paste that onto a folder and macOS has to blow up a thumbnail to fill a 512-point slot. It will be blurry, and no amount of retrying will change that.

The right one: you open the image in Preview, press ⌘A to select the whole picture, then ⌘C. That puts the actual pixel data on the clipboard at full resolution. Then you go to the folder's Get Info window, click its small icon once so it takes a blue highlight, and press ⌘V.

Same two keystrokes, radically different result. If your icon is blurry and you've never opened the source image in Preview before copying, this is almost certainly your answer.

Give macOS something to work with: 1024 × 1024

A macOS icon is not one image. It's a set of representations that Finder picks from depending on the view and the display — from 16 pixels in a list view up to 512 points in a large icon view, which on a Retina screen means 1024 actual pixels.

So a 512 × 512 source that looks perfect in a small grid turns soft the moment you drag the icon-size slider up, or open the folder on a Studio Display. Supply a square 1024 × 1024 image and every representation is downscaled from something larger, which macOS does cleanly. Downscaling is safe; upscaling never is.

Apple's own icon guidance works from a 1024 × 1024 master for exactly this reason — see the Human Interface Guidelines link at the bottom of this page.

Square, or macOS will decide for you

Icon slots are square. Hand macOS a 1600 × 900 screenshot and it fits your image into a square box — the picture ends up smaller than the slot with empty space above and below, so the visible artwork is drawn at a fraction of the resolution you thought you gave it. The result reads as blurry even though the file was large.

Crop to a 1:1 ratio before you copy. In Preview: Tools > Adjust Size to check the dimensions, and the selection tool with Shift held to constrain a square crop, then Tools > Crop.

PNG with real transparency, not a JPEG

A JPEG always has a background. If your artwork was designed to sit on the folder shape with transparency around it, saving it as JPEG fills that transparency with white — you get a crisp white square instead of a shaped icon, which most people read as "it looks wrong" rather than "it looks blurry", but the two complaints arrive together often enough to be worth stating.

JPEG also compresses lossily. Re-saving a JPEG that was already compressed, at a small size, stacks artifacts that survive being scaled up into an icon. Use PNG. macOS will not remove a white background for you, and neither will Preview's export dialog.

Finder is showing you a cached copy

Sometimes the icon you applied is fine and Finder is still drawing the old one. macOS caches icon representations aggressively, and a folder that has been through two or three icon changes can keep showing an earlier, lower-resolution version.

In order of how much they disturb, the things that actually clear it:

If the icon is sharp again after any of those, the paste had worked all along. Resist the urge to go deleting cache files by hand — on current macOS the icon services cache is system-managed and protected, and removing it manually is more likely to cost you an afternoon than to fix anything.

Check what you actually applied

Before assuming a fix failed, verify at full size. Open the folder's enclosing window, switch to icon view (⌘1) and drag the icon-size slider — in View > Show View Options (⌘J) — all the way up. A correctly applied 1024 px icon stays clean at maximum size. A copied thumbnail falls apart well before that, and now you know which one you have.

Also worth knowing: a custom icon lives in the folder's Finder metadata, not inside the folder. Zipping it, putting it through a third-party cloud sync, or moving it to a non-Mac filesystem can strip the icon or leave a degraded version behind. iCloud Drive preserves them.

If you're doing this for a whole desktop, stop hand-cropping

Everything above is worth doing for one or two folders. It stops being worth doing around the fifth — finding artwork, cropping it square, exporting a transparent PNG at 1024, copying it out of Preview and pasting it into Get Info, one folder at a time, is a genuinely tedious loop and every step is a chance to reintroduce the blur.

Mac+ is a native macOS app that removes the resolution question entirely: it renders its 52 patterns directly onto the real macOS folder shape at full icon resolution, so there is no source file to get wrong. Drop in your own image and it fits it to the folder shape and exports every representation for you. You can apply one style to a batch of folders in a single action, and reset any of them to Apple's default blue with one click.

The free tier includes 6 folder icons and the palettes, which is enough to see whether the result is sharper than what you were getting by hand.

The fix, in 5 steps

  1. Get or make a square image, 1024 × 1024 pixels, saved as a PNG. If it needs a transparent background, make sure it already has one — macOS won't add it.
  2. Open that file in Preview (not Get Info, not Quick Look). Press ⌘A to select the whole image, then ⌘C to copy it.
  3. In Finder, click the target folder once, then press ⌘ + I to open Get Info.
  4. Click the small folder icon in the very top-left corner of the Get Info window, so it picks up a blue highlight. Press ⌘V.
  5. Check it at full size: ⌘1 for icon view, ⌘J, and drag the icon size slider to maximum. If it's still soft, relaunch Finder before trying anything else.
↓ Download Mac+ free Mac+ home

macOS 13 or later. Apple Silicon and Intel. Free tier, no account required.

Frequently asked questions

Why is my custom folder icon blurry on Mac?

Most often because the clipboard held a small icon thumbnail rather than the image itself. Copying a file's icon from its Get Info window gives you a 32 or 128 pixel representation; opening the image in Preview and pressing ⌘A then ⌘C gives you the full-resolution picture. The second one produces a sharp folder icon.

What size should a Mac folder icon be?

1024 × 1024 pixels, square. macOS builds every smaller representation down from your source, and downscaling is clean while upscaling is not. A 512 × 512 image looks fine in small views but goes soft at large icon sizes on a Retina display.

Does the image have to be square?

Yes, in practice. Icon slots are square, so a rectangular image gets fitted inside one with empty space around it. The visible artwork ends up drawn at a fraction of the slot's resolution, which reads as blurry even when the source file was large. Crop to 1:1 before copying.

Should I use PNG or JPEG for a folder icon?

PNG. JPEG cannot store transparency, so any transparent background becomes white, and its lossy compression adds artifacts that get magnified when the image is scaled into an icon. PNG keeps both the transparency and the detail.

My icon looked fine and now it's blurry again. Why?

Usually Finder redrawing a cached representation. Relaunch Finder by Option-right-clicking it in the Dock and choosing Relaunch, or log out and back in. If the icon has also travelled through a zip archive or a third-party cloud sync, it may genuinely have been stripped or degraded — custom icons live in Finder metadata, not in the folder.

How do I clear the icon cache on macOS?

You mostly shouldn't need to. Relaunching Finder, logging out, or restarting clears what's realistically clearable. On current macOS the icon services cache is system-managed and protected, and deleting it by hand tends to create more problems than it solves.

Is there a way to avoid this entirely?

Use an app that renders the icon at full resolution instead of pasting an image through the clipboard. Mac+ maps its patterns onto the real macOS folder shape and generates every icon representation itself, so there is no source file resolution to get wrong, and it can apply a style to many folders at once.

Keep reading

Sources

← All guides