---
title: image
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibutton/configuration-swift.struct/image
---

# image

The foreground image the button displays.

## Declaration

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

## Discussion

Discussion A configuration contains one image. To change the image based on button state, use configurationUpdateHandler or updateConfiguration().

## See Also

### Configuring images

- [imagePadding](uikit/uibutton/configuration-swift.struct/imagepadding.md)
- [imagePlacement](uikit/uibutton/configuration-swift.struct/imageplacement.md)
- [imageReservation](uikit/uibutton/configuration-swift.struct/imagereservation.md)
- [imageColorTransformer](uikit/uibutton/configuration-swift.struct/imagecolortransformer.md)
- [preferredSymbolConfigurationForImage](uikit/uibutton/configuration-swift.struct/preferredsymbolconfigurationforimage.md)