---
title: "setPreferredSymbolConfiguration(_:forImageIn:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uibutton/setpreferredsymbolconfiguration(_:forimagein:)"
---

# setPreferredSymbolConfiguration(_:forImageIn:)

Sets the preferred symbol configuration for a button state.

## Declaration

```swift
func setPreferredSymbolConfiguration(_ configuration: UIImage.SymbolConfiguration?, forImageIn state: UIControl.State)
```

## Parameters

- `configuration`: The image symbol configuration for the specified state.
- `state`: The state that uses the specified image symbol configuration. Possible values are described in doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct.

## See Also

### Managing images and tint color

- [backgroundImage(for:)](uikit/uibutton/backgroundimage(for:).md)
- [image(for:)](uikit/uibutton/image(for:).md)
- [setBackgroundImage(_:for:)](uikit/uibutton/setbackgroundimage(_:for:).md)
- [setImage(_:for:)](uikit/uibutton/setimage(_:for:).md)
- [preferredSymbolConfigurationForImage(in:)](uikit/uibutton/preferredsymbolconfigurationforimage(in:).md)
- [tintColor](uikit/uibutton/tintcolor.md)