---
title: image
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibuttonconfiguration/image
---

# image

The foreground image the button displays.

## Declaration

```occ
@property (nonatomic, strong, readwrite, nullable) UIImage * image;
```

## 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/uibuttonconfiguration/imagepadding.md)
- [imagePlacement](uikit/uibuttonconfiguration/imageplacement.md)
- [imageColorTransformer](uikit/uibuttonconfiguration/imagecolortransformer.md)
- [preferredSymbolConfigurationForImage](uikit/uibuttonconfiguration/preferredsymbolconfigurationforimage.md)