---
title: "setBackgroundImage(_:)"
framework: watchkit
role: symbol
role_heading: Instance Method
path: "watchkit/wkinterfacebutton/setbackgroundimage(_:)"
---

# setBackgroundImage(_:)

Sets the button’s background image to the specified image.

## Declaration

```swift
func setBackgroundImage(_ image: UIImage?)
```

## Parameters

- `image`: The image to be displayed behind the button’s title text. The image is displayed behind the button’s title text. Specifying nil removes the existing image. You may specify an image object that contains multiple images running as an animation. The image is scaled as needed to fill the button’s content area.

## Discussion

Discussion If image is a template image, the button tints that image using the current background color. The button does not use the background color for full-color images.

## See Also

### Setting the Button Background

- [setBackgroundColor(_:)](watchkit/wkinterfacebutton/setbackgroundcolor(_:).md)
- [setBackgroundImageData(_:)](watchkit/wkinterfacebutton/setbackgroundimagedata(_:).md)
- [setBackgroundImageNamed(_:)](watchkit/wkinterfacebutton/setbackgroundimagenamed(_:).md)