---
title: "setSearchFieldBackgroundImage(_:for:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uisearchbar/setsearchfieldbackgroundimage(_:for:)"
---

# setSearchFieldBackgroundImage(_:for:)

Sets the search text field image for a given state.

## Declaration

```swift
func setSearchFieldBackgroundImage(_ backgroundImage: UIImage?, for state: UIControl.State)
```

## Parameters

- `backgroundImage`: The search text field image to use for state.
- `state`: A control state. Valid states are doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct/normal and doc://com.apple.uikit/documentation/UIKit/UIControl/State-swift.struct/disabled.

## See Also

### Customizing the search bar appearance

- [backgroundImage](uikit/uisearchbar/backgroundimage.md)
- [backgroundImage(for:barMetrics:)](uikit/uisearchbar/backgroundimage(for:barmetrics:).md)
- [setBackgroundImage(_:for:barMetrics:)](uikit/uisearchbar/setbackgroundimage(_:for:barmetrics:).md)
- [image(for:state:)](uikit/uisearchbar/image(for:state:).md)
- [setImage(_:for:state:)](uikit/uisearchbar/setimage(_:for:state:).md)
- [positionAdjustment(for:)](uikit/uisearchbar/positionadjustment(for:).md)
- [setPositionAdjustment(_:for:)](uikit/uisearchbar/setpositionadjustment(_:for:).md)
- [inputAccessoryView](uikit/uisearchbar/inputaccessoryview.md)
- [searchFieldBackgroundImage(for:)](uikit/uisearchbar/searchfieldbackgroundimage(for:).md)
- [searchFieldBackgroundPositionAdjustment](uikit/uisearchbar/searchfieldbackgroundpositionadjustment.md)
- [searchTextPositionAdjustment](uikit/uisearchbar/searchtextpositionadjustment.md)