---
title: "How macOS Wallpapers Work"
description: "The wallpaper layer, per-display and per-Space assignment, dynamic desktop pictures, and why Lock Screen video needs a recent macOS version."
canonical: "https://macwall.app/learn/how-macos-wallpapers-work"
published: "2026-08-02"
updated: "2026-08-02"
keywords:
  - "how macos wallpaper works"
  - "macos wallpaper layer"
  - "macos desktop picture"
  - "macos lock screen wallpaper api"
---

# How macOS wallpapers actually work

The wallpaper layer, per-display and per-Space assignment, dynamic desktop pictures, and why Lock Screen video needs a recent macOS version.

The macOS desktop is a stack of composited layers. The wallpaper is the bottom one — below desktop icons, below every window, below the Dock and menu bar. The window server draws it once and reuses it, which is why a static picture costs essentially nothing.

## The layer stack, bottom to top

1. **Wallpaper layer** — your desktop picture or, with a live wallpaper app, a decoded video surface.
2. **Desktop icons** — Finder draws these in their own layer above the wallpaper.
3. **Application windows** — everything you actually work in.
4. **System UI** — menu bar, Dock, Notification Center, Control Center.

Because a live wallpaper only replaces the bottom layer, nothing above it is affected: click-through, window management, screenshots of windows, and Mission Control all behave identically.

## Per-display and per-Space

- Each connected display holds its own wallpaper assignment, so different monitors can show different content.
- Spaces can each carry a wallpaper too — a legacy of macOS letting you theme individual desktops.
- Assignments are remembered per display identity. Unplug a monitor, plug it back in, and its wallpaper returns.

## Dynamic desktop pictures

Apple's built-in dynamic wallpapers are HEIC files containing several images plus metadata describing which to show for a given sun position or appearance mode. They are still images on a schedule — genuinely useful, but not motion. Video wallpaper is a different mechanism entirely.

## The Lock Screen is a separate surface

The Lock Screen and Screen Saver are rendered by the system before your session is unlocked, so an app cannot simply draw into them. Apple added APIs that let apps register a video as a system wallpaper asset in macOS 26 (Tahoe); below that version no third-party app can put motion on the Lock Screen, regardless of what it claims. Once registered, macOS — not the app — plays the loop, which is why applying one takes a moment while the system indexes the asset.

## What this means when you pick an app

- Apps that use the real wallpaper layer behave like a native wallpaper. Apps that float a borderless window behind your icons only imitate one — and break with Mission Control, screenshots, and Spaces.
- A native app needs no Screen Recording, Accessibility, or Full Disk Access permission to set a wallpaper. Being asked for those is a signal something unusual is happening.
- MacWall uses the system wallpaper APIs on both surfaces — see [Live Lock Screen and Screen Saver](https://macwall.app/docs/live-lock-screen-and-screen-saver).

## Frequently asked questions

### Can an app change the Lock Screen wallpaper on older macOS?

Not with video. The API for registering a video wallpaper asset arrived in macOS 26 (Tahoe). Desktop live wallpapers work on macOS 14 and later.

### Why does the wallpaper sometimes need a re-apply after a macOS update?

Updates can invalidate cached wallpaper assets. Re-applying rewrites the asset, and logging out forces macOS to reload the whole set.

### Do live wallpapers appear in screenshots?

A full-screen capture includes whatever frame is on screen, exactly like a static wallpaper. Window captures are unaffected.

---

Source: https://macwall.app/learn/how-macos-wallpapers-work