---
title: "image(for:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uibutton/image(for:)"
---

# image(for:)

Returns the image used for a button state.

## Declaration

```swift
func image(for state: UIControl.State) -> UIImage?
```

## Parameters

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

## Return Value

Return Value The image used for the specified state.

## See Also

### Managing images and tint color

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