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

# preferredSymbolConfigurationForImage

A requested configuration object for the button symbol image.

## Declaration

```swift
var preferredSymbolConfigurationForImage: UIImage.SymbolConfiguration? { get set }
```

## Discussion

Discussion A symbol configuration defines details such as the point size, scale, text style, weight, and font of symbol image. The button uses these details to determine which variant of the image to use and how to scale or style the image.

## See Also

### Configuring images

- [image](uikit/uibutton/configuration-swift.struct/image.md)
- [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)