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

# setStatusBarStyle(_:animated:)

Sets the style of the status bar, optionally animating the transition to the new style.

## Declaration

```swift
func setStatusBarStyle(_ statusBarStyle: UIStatusBarStyle, animated: Bool)
```

## Parameters

- `statusBarStyle`: A constant that specifies a style for the status bar. See the descriptions of the constants in doc://com.apple.uikit/documentation/UIKit/UIStatusBarStyle for details.
- `animated`: doc://com.apple.documentation/documentation/Swift/true if the transition to the new style should be animated; otherwise doc://com.apple.documentation/documentation/Swift/false .

## Discussion

Discussion The animation slides the status bar out toward the top of the interface. In iOS 7 and later, status bar behavior is determined by view controllers, and so calling this method has no effect by default. When view controller-based status bar appearance is disabled, this method behaves normally. To opt out of the view controller-based status bar appearance behavior, you must add the UIViewControllerBasedStatusBarAppearance key with a value of false to your app’s Info.plist file, but doing so is not recommended.

## See Also

### Related Documentation

- [statusBarStyle](uikit/uiapplication/statusbarstyle.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)
- [setStatusBarOrientation(_:animated:)](uikit/uiapplication/setstatusbarorientation(_:animated:).md)
- [registerUserNotificationSettings(_:)](uikit/uiapplication/registerusernotificationsettings(_:).md)
- [registerForRemoteNotifications(matching:)](uikit/uiapplication/registerforremotenotifications(matching:).md)