---
title: backgroundImage
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibarappearance/backgroundimage
---

# backgroundImage

The image to display on top of the bar’s background color.

## Declaration

```swift
var backgroundImage: UIImage? { get set }
```

## Discussion

Discussion The bar layers the specified image on top of the content in the backgroundEffect and backgroundColor properties. UIKit sizes the image according to the value in the backgroundImageContentMode property.

## See Also

### Configuring the background appearance

- [backgroundEffect](uikit/uibarappearance/backgroundeffect.md)
- [backgroundColor](uikit/uibarappearance/backgroundcolor.md)
- [backgroundImageContentMode](uikit/uibarappearance/backgroundimagecontentmode.md)