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

# NSPrefersDisplaySafeAreaCompatibilityMode

A Boolean value that indicates whether the app prefers to run in compatibility mode when necessary.

## Discussion

On Mac computers that include a camera housing in the screen bezel, the system provides a compatibility mode to prevent apps from unintentionally putting content in the region the housing occupies. When this mode is active, the system changes the active area of the display to avoid the camera housing. The new active area ensures your app’s contents are always visible and not obscured by the camera housing. The system activates this compatibility mode when an app that requires it places a window behind the camera housing in the current desktop or full-screen space.

On Mac computers that include a camera housing, the Finder adds a checkbox to your app’s Get Info panel to enable or disable compatibility mode. If your app’s `Info.plist` file includes the [`NSPrefersDisplaySafeAreaCompatibilityMode`](/documentation/BundleResources/Information-Property-List/NSPrefersDisplaySafeAreaCompatibilityMode) key, the Finder doesn’t add that checkbox; instead, it uses the value of the key to determine whether to run your app in compatibility mode. Set the value of the key to <doc://com.apple.documentation/documentation/Swift/true> to always run your app in compatibility mode, and set it to <doc://com.apple.documentation/documentation/Swift/false> to never run your app in compatibility mode.

After you audit your app and verify that it runs correctly on Mac computers that include a camera housing, add this key to your `Info.plist` file and set its value to <doc://com.apple.documentation/documentation/Swift/false>. If you discover issues during your audit, add the key and set its value to <doc://com.apple.documentation/documentation/Swift/true> until you’re able to fix those issues.

> Note:
> On Mac computers that include a camera housing in the bezel, the <doc://com.apple.documentation/documentation/AppKit/NSScreen/auxiliaryTopLeftArea-uglc> and <doc://com.apple.documentation/documentation/AppKit/NSScreen/auxiliaryTopRightArea-gr2n> properties of <doc://com.apple.documentation/documentation/AppKit/NSScreen> contain the regions to the left and right of the camera housing. Use those properties and the <doc://com.apple.documentation/documentation/AppKit/NSScreen/visibleFrame> property to determine where to display your content.

---

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)