Troubleshooting Mac wallpaper problems

Mac wallpapers usually just work. But when they don't — stuck on the wrong image, reverting after sleep, looking weirdly blurry — it's annoying because there's no obvious error message. Here are fixes for the problems people actually run into.

Try these first

Before digging into specific issues, these fix most wallpaper weirdness:

Restart. Yes, really. Wallpaper state is cached and a restart clears it.
Re-select the wallpaper. Go to System Settings → Wallpaper and choose it again, even if it looks selected already.
Check the file. Make sure the image file still exists where it was. If you moved, renamed, or deleted it, macOS loses track.

Wallpaper won't change

You select a new wallpaper in System Settings but your desktop doesn't update.

Fix: Kill the Dock

The Dock process manages wallpaper rendering. Force-quit it and it restarts fresh:

killall Dock

Your Dock disappears for a second and comes back. Try setting the wallpaper again.

Fix: Reset wallpaper preferences

If killall Dock didn't work, clear the wallpaper preference entirely:

defaults delete com.apple.desktop
killall Dock

This resets your wallpaper to the macOS default. Then set your desired wallpaper fresh.

Fix: Check file permissions

If the wallpaper image is on an external drive, in a restricted folder, or has weird permissions, macOS can't read it. Right-click the file → Get Info → check that your user has Read access under Sharing & Permissions.

Wallpaper resets after sleep or restart

You set a wallpaper, close your laptop, open it again — and it's reverted to the default or a previous wallpaper.

Fix: Reset NVRAM

NVRAM stores display settings. Corrupted NVRAM can cause wallpaper resets:

Intel Macs: Shut down. Turn on and immediately hold Option + Command + P + R for 20 seconds.
Apple Silicon Macs: Shut down completely (not sleep). Wait 30 seconds. Turn back on. NVRAM resets automatically if needed.

Fix: Remove the desktoppicture.db file

rm ~/Library/Application\ Support/Dock/desktoppicture.db
killall Dock

This deletes the wallpaper database. macOS rebuilds it on next set.

Wallpaper looks blurry

The image looks soft or pixelated on your Retina display.

Cause: Image is too small

Your display is probably 3024×1964 or higher. If the wallpaper is 1920×1080, macOS stretches it to fill — and stretching makes it blurry. Check the image dimensions (Get Info or Preview → Tools → Adjust Size).

Fix: get a higher-resolution version. For current Macs, 3840×2160 is the minimum that looks sharp. 5120×2880 is ideal.

Cause: JPEG compression artifacts

A heavily compressed JPEG (quality below 70%) will show blocky artifacts, especially in smooth gradients like skies. Look for a less-compressed version, or use PNG/HEIC.

Wallpaper rotation stopped working

You set up folder-based rotation but it's stuck on one image.

Check the folder. Open it in Finder. Are there actually multiple images in it? Did you accidentally point at the wrong folder?
Check file formats. macOS wallpaper rotation only picks up JPEG, PNG, HEIC, and TIFF. Other formats (WebP, GIF, BMP) may be skipped.
Re-add the folder. Remove it from wallpaper settings and add it again fresh.
Separate Spaces setting. If "Displays have separate Spaces" was toggled, wallpaper settings can get confused. Re-set after changing that option.

Different Spaces show the same wallpaper

You set different wallpapers per Space but they all show the same one.

Fix: Make sure "Displays have separate Spaces" is enabled in System Settings → Desktop & Dock → Mission Control. Without this, Spaces can't have independent wallpapers. After toggling this on, you need to log out and back in.

Dynamic wallpaper stuck on one phase

Your time-of-day dynamic wallpaper isn't transitioning.

Check that you selected "Dynamic" (not "Light" or "Dark") in the wallpaper options dropdown
Verify your time zone is set correctly (System Settings → General → Date & Time)
For solar-based dynamic wallpapers, Location Services must be enabled

Wallpaper appears zoomed or cropped weirdly

Check the fill mode in System Settings → Wallpaper. "Fill Screen" crops to fill. "Fit to Screen" shows the whole image with possible black bars. If the wallpaper's aspect ratio doesn't match your display, some cropping is unavoidable in Fill mode. Use an image that matches your display's aspect ratio (16:10 for MacBooks) to avoid this.

When nothing else works

Create a new user account and test wallpapers there. If it works, the issue is in your user profile, not macOS.
Boot into Safe Mode (hold Shift during startup on Intel, hold power button on Apple Silicon until "Loading startup options" appears). If wallpapers work in Safe Mode, a login item or extension is interfering.
Update macOS. Apple fixes wallpaper bugs in point releases.