---
title: "requestGeometryUpdate(_:errorHandler:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiwindowscene/requestgeometryupdate(_:errorhandler:)"
---

# requestGeometryUpdate(_:errorHandler:)

Requests an update to the window scene’s geometry using the specified geometry preferences object.

## Declaration

```swift
func requestGeometryUpdate(_ geometryPreferences: UIWindowScene.GeometryPreferences, errorHandler: ((any Error) -> Void)? = nil)
```

## Parameters

- `geometryPreferences`: The geometry information to use for the request.
- `errorHandler`: An optional closure to call when an error occurs. The system may call the error handler asynchronously.

## Discussion

Discussion Use this method to explicitly request geometry changes to the window scene. The following code shows an example of requesting the window scene to rotate to a landscape orientation in iOS. // In a view controller, get the window scene. guard let windowScene = view.window?.windowScene else { return }

// Request the window scene to rotate to any landscape orientation. windowScene.requestGeometryUpdate(.iOS(interfaceOrientations: .landscape)) { error in     // Handle denial of request. }

## See Also

### Working with window geometry

- [effectiveGeometry](uikit/uiwindowscene/effectivegeometry.md)
- [UIWindowScene.Geometry](uikit/uiwindowscene/geometry.md)
- [UIWindowScene.GeometryPreferences](uikit/uiwindowscene/geometrypreferences.md)
- [UIWindowScene.GeometryPreferences.iOS](uikit/uiwindowscene/geometrypreferences/ios.md)
- [UIWindowScene.GeometryPreferences.Mac](uikit/uiwindowscene/geometrypreferences/mac.md)
- [UIWindowScene.GeometryPreferences.Vision](uikit/uiwindowscene/geometrypreferences/vision.md)
- [UIProposedSceneSizeNoPreference](uikit/uiproposedscenesizenopreference.md)