---
title: "setStatusBarOrientation(_:animated:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiapplication/setstatusbarorientation(_:animated:)"
---

# setStatusBarOrientation(_:animated:)

Sets the app’s status bar to the specified orientation, optionally animating the transition.

## Declaration

```swift
func setStatusBarOrientation(_ interfaceOrientation: UIInterfaceOrientation, animated: Bool)
```

## Parameters

- `interfaceOrientation`: A specific orientation of the status bar. See doc://com.apple.uikit/documentation/UIKit/UIInterfaceOrientation for details. The default value is doc://com.apple.uikit/documentation/UIKit/UIInterfaceOrientation/portrait.
- `animated`: doc://com.apple.documentation/documentation/Swift/true if the transition to the new orientation should be animated; doc://com.apple.documentation/documentation/Swift/false if it should be immediate, without animation.

## Discussion

Discussion Calling this method changes the value of the  statusBarOrientation property and rotates the status bar, animating the transition if animated is true . If your app has rotatable window content, however, you should not arbitrarily set status-bar orientation using this method. The status-bar orientation set by this method does not change if the device changes orientation.

## See Also

### Related Documentation

- [statusBarOrientationAnimationDuration](uikit/uiapplication/statusbarorientationanimationduration.md)
- [statusBarOrientation](uikit/uiapplication/statusbarorientation.md)

### Deprecated methods

- [requestSceneSessionActivation(_:userActivity:options:errorHandler:)](uikit/uiapplication/requestscenesessionactivation(_:useractivity:options:errorhandler:).md)
- [beginIgnoringInteractionEvents()](uikit/uiapplication/beginignoringinteractionevents().md)
- [endIgnoringInteractionEvents()](uikit/uiapplication/endignoringinteractionevents().md)
- [setMinimumBackgroundFetchInterval(_:)](uikit/uiapplication/setminimumbackgroundfetchinterval(_:).md)
- [scheduleLocalNotification(_:)](uikit/uiapplication/schedulelocalnotification(_:).md)
- [presentLocalNotificationNow(_:)](uikit/uiapplication/presentlocalnotificationnow(_:).md)
- [cancelLocalNotification(_:)](uikit/uiapplication/cancellocalnotification(_:).md)
- [cancelAllLocalNotifications()](uikit/uiapplication/cancelalllocalnotifications().md)
- [setKeepAliveTimeout(_:handler:)](uikit/uiapplication/setkeepalivetimeout(_:handler:).md)
- [UIMinimumKeepAliveTimeout](uikit/uiminimumkeepalivetimeout.md)
- [clearKeepAliveTimeout()](uikit/uiapplication/clearkeepalivetimeout().md)
- [setStatusBarHidden(_:with:)](uikit/uiapplication/setstatusbarhidden(_:with:).md)
- [setStatusBarStyle(_:animated:)](uikit/uiapplication/setstatusbarstyle(_:animated:).md)
- [registerUserNotificationSettings(_:)](uikit/uiapplication/registerusernotificationsettings(_:).md)
- [registerForRemoteNotifications(matching:)](uikit/uiapplication/registerforremotenotifications(matching:).md)