---
title: "setBackButtonBackgroundImage(_:for:barMetrics:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uibarbuttonitem/setbackbuttonbackgroundimage(_:for:barmetrics:)"
---

# setBackButtonBackgroundImage(_:for:barMetrics:)

Sets the back button background image for a specified control state and bar metrics.

## Declaration

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

## Parameters

- `backgroundImage`: The image to use for the back button’s background.
- `state`: A control state.
- `barMetrics`: Bar metrics.

## Discussion

Discussion This modifier applies only to navigation bar back buttons and is ignored by other buttons. For good results, backgroundImage must be a stretchable image.

## See Also

### Customizing the Back button

- [backButtonBackgroundImage(for:barMetrics:)](uikit/uibarbuttonitem/backbuttonbackgroundimage(for:barmetrics:).md)
- [backButtonTitlePositionAdjustment(for:)](uikit/uibarbuttonitem/backbuttontitlepositionadjustment(for:).md)
- [setBackButtonTitlePositionAdjustment(_:for:)](uikit/uibarbuttonitem/setbackbuttontitlepositionadjustment(_:for:).md)
- [backButtonBackgroundVerticalPositionAdjustment(for:)](uikit/uibarbuttonitem/backbuttonbackgroundverticalpositionadjustment(for:).md)
- [setBackButtonBackgroundVerticalPositionAdjustment(_:for:)](uikit/uibarbuttonitem/setbackbuttonbackgroundverticalpositionadjustment(_:for:).md)