<!--
{
  "availability" : [
    "macOS: 12.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/UISupportsTrueScreenSizeOnMac",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.UISupportsTrueScreenSizeOnMac"
  },
  "title" : "UISupportsTrueScreenSizeOnMac"
}
-->

# UISupportsTrueScreenSizeOnMac

A Boolean value that indicates whether your iPad app supports arbitrary screen sizes and resolutions when running on a Mac.

## Discussion

To declare support for arbitrary screen sizes and resolutions when running your iPad app in macOS, add this key to your app’s `Info.plist` file and set its value to <doc://com.apple.documentation/documentation/Swift/true>. This key has no effect when:

- The app supports iPad multitasking and resizable windows. For more information, see [`UIRequiresFullScreen`](/documentation/BundleResources/Information-Property-List/UIRequiresFullScreen).
- The app is running on other Apple platforms.
- The app is built with <doc://com.apple.documentation/documentation/UIKit/mac-catalyst>.

The use of this key implies that your app is capable of handling a variety of display configurations available on a Mac, including:

- Small to large display resolutions; for example, 640 x 480 to 8K and beyond.
- Retina and non-Retina displays.
- All conceivable aspect ratios, including portrait and 21:9 ultrawide.

Use of the [`UISupportsTrueScreenSizeOnMac`](/documentation/BundleResources/Information-Property-List/UISupportsTrueScreenSizeOnMac) key also implies that your app is capable of handling portrait and landscape sizes even when they don’t align with the device orientation. For instance, if your app supports rotation in iPadOS, the device orientation is always landscape even though the display might have a portrait aspect ratio in reality.

> Note:
> When running your iPad app on a Mac, macOS chooses the device orientation of your app from the set of app-supported orientations for iOS, regardless of the actual Mac display aspect ratio. This means that you don’t need to update the set of iOS-supported orientations (see ``doc://com.apple.bundleresources/documentation/BundleResources/Information-Property-List/UISupportedInterfaceOrientations``), or alter your code to handle unsupported orientations when using the ``doc://com.apple.bundleresources/documentation/BundleResources/Information-Property-List/UISupportsTrueScreenSizeOnMac`` key.

When you include [`UISupportsTrueScreenSizeOnMac`](/documentation/BundleResources/Information-Property-List/UISupportsTrueScreenSizeOnMac) in your app, your app is responsible for:

- Handling memory management concerns that may occur when running at extreme resolutions.
- Handling layout concerns for different aspect ratios, such as correct button placement.
- Letterboxing and pillarboxing as needed if your app requires a specific aspect ratio.

To provide a pixel-perfect, edge-to-edge, full-screen experience, use [`UISupportsTrueScreenSizeOnMac`](/documentation/BundleResources/Information-Property-List/UISupportsTrueScreenSizeOnMac) along with the [`UILaunchToFullScreenByDefaultOnMac`](/documentation/BundleResources/Information-Property-List/UILaunchToFullScreenByDefaultOnMac) key.

---

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)