is UIRequiresFullScreen deprecated or not?

The information coming from Apple is very confusing. https://developer.apple.com/documentation/technotes/tn3192-Migrating-your-app-from-the-deprecated-UIRequiresFullScreen-key says two opposite things:

(1) "Starting in iPadOS 26, UIRequiresFullScreen and its associated compatibility mode are deprecated" and you should migrate away.

(2) "Starting in iOS 27 and iPadOS 27, UIRequiresFullScreen no longer opts your app out of resizing on either platform. Instead, the system resizes your app’s scene discretely. This behavior applies when you build your app with the iOS 27 SDK or later and set UIRequiresFullScreen to YES"

The thing is that (2) implies that UIRequiresFullScreen is legal and in fact is supposed to have a well-defined new behavior, "discrete resizing". I have not been able to detect any evidence of this "discrete resizing" and I don't understand what it is. But the important thing is (2) makes it sound legal but (1) makes it sound illegal. What's true?

@mattn Thanks for the question and pointing out the in the tech note as UIRequiresFullScreen is deprecated as it shows in the documentation below:

https://developer.apple.com/documentation/BundleResources/Information-Property-List/UIRequiresFullScreen

iOS will continue to honor the UIRequiresFullScreen key, but your app will still resize when someone opens or closes their iPhone Duo for example in a case I know.

Xcode should be warning about UIRequiresFullScreen and it does in Xcode 27.2 for sure.

I know in the Duo this is how is explained well:
https://developer.apple.com/videos/play/tech-talks/111461/?time=279

I would be more interested to know the reasons you want to use it and where.

Thanks

Albert  WWDR

The video https://developer.apple.com/videos/play/wwdc2026/278 says explicitly that it is okay for games that require landscape orientation to declare UIRequiresFullscreen. "UIRequiresFullScreen is honored on iPhone in resizable environments starting in iOS 27. Its behavior has also been updated and no longer opts your app fully out of resizing. Instead, it enables discrete resizing that honors your supported interface orientations." I would like to see this in action, and use it in my apps. But I am not seeing it do anything useful, and the deprecation warning is still there. This seems contradictory to me: the video invites me to use UIRequiresFullScreen, but Xcode discourages me from doing so.

@mattn I would like to provide a comment if I may, the video does not invite you to use UIRequiresFullScreen it It says you can and that it will continue to be honored I know that it may be confusing on the video itself.

Albert  WWDR