<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSWindow/miniwindowImage",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSWindow(py)miniwindowImage"
  },
  "title" : "miniwindowImage"
}
-->

# miniwindowImage

The custom miniaturized window image of the window.

```
var miniwindowImage: NSImage? { get set }
```

## Discussion

The miniaturized window image is the image displayed in the Dock when the window is minimized. If you did not assign a custom image to the window, the value of this property is `nil`.

When the user minimizes the window, the Dock displays [`miniwindowImage`](/documentation/AppKit/NSWindow/miniwindowImage) in the corresponding Dock tile, scaling it as needed to fit in the tile. If you do not specify a custom image using this property, the Dock creates one for you automatically.

You can also set this property as needed to change the minimized window image. Typically, you would specify a custom image immediately prior to a window being minimized—when the system posts [`willMiniaturizeNotification`](/documentation/AppKit/NSWindow/willMiniaturizeNotification). You can set this property while the window is minimized to update the current image in the Dock. However, you should not use this property to create complex animations in the Dock.

Support for custom images is disabled by default. To enable support, set the `AppleDockIconEnabled` key to <doc://com.apple.documentation/documentation/Swift/true> when first registering your application’s user defaults. You must set this key prior to calling the `init` method of [`NSApplication`](/documentation/AppKit/NSApplication), which reads the current value of the key.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)