---
title: background
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibutton/configuration-swift.struct/background
---

# background

The configuration to customize the button background.

## Declaration

```swift
var background: UIBackgroundConfiguration { get set }
```

## Discussion

Discussion The button lays out foreground configuration elements such as title, subtitle, and image on top of background elements. Use this property for detailed control over the background.

## See Also

### Configuring the button background

- [cornerStyle](uikit/uibutton/configuration-swift.struct/cornerstyle-swift.property.md)
- [UIButton.Configuration.CornerStyle](uikit/uibutton/configuration-swift.struct/cornerstyle-swift.enum.md)
