---
title: image
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nsbutton/image
---

# image

The image that appears on the button when it’s in an off state, or nil if there is no such image.

## Declaration

```swift
var image: NSImage? { get set }
```

## Discussion

Discussion The image contained in this property is always displayed on a button that doesn’t change its contents when highlighting or showing an on state. Buttons don’t display images by default.

## See Also

### Related Documentation

- [setButtonType(_:)](appkit/nsbutton/setbuttontype(_:).md)

### Configuring button images

- [alternateImage](appkit/nsbutton/alternateimage.md)
- [imagePosition](appkit/nsbutton/imageposition.md)
- [NSControl.ImagePosition](appkit/nscontrol/imageposition.md)
- [isBordered](appkit/nsbutton/isbordered.md)
- [isTransparent](appkit/nsbutton/istransparent.md)
- [bezelStyle](appkit/nsbutton/bezelstyle-swift.property.md)
- [bezelColor](appkit/nsbutton/bezelcolor.md)
- [showsBorderOnlyWhileMouseInside](appkit/nsbutton/showsborderonlywhilemouseinside.md)
- [imageHugsTitle](appkit/nsbutton/imagehugstitle.md)
- [imageScaling](appkit/nsbutton/imagescaling.md)