<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: -",
    "tvOS: 15.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIButton/Configuration-swift.struct/imageReservation",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "s:So8UIButtonC5UIKitE13ConfigurationV16imageReservation14CoreFoundation7CGFloatVvp"
  },
  "title" : "imageReservation"
}
-->

# imageReservation

A value that reserves space for the image in the same axis as the edge against which the button places the image.

```
var imageReservation: CGFloat { get set }
```

## Discussion

Defaults to `0`. The value reserves space in the axis that corresponds to [`imagePlacement`](/documentation/UIKit/UIButtonConfiguration/imagePlacement). If the image is larger than the reservation value in that axis, the system ignores the reservation value. Otherwise, the system centers the image in the space that the reservation value provides.

If the image is a symbol image, the system scales the reservation value with dynamic type, based on the image configuration.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)