---
title: Preference Panes
framework: Preference Panes
role: collection
role_heading: Framework
platforms: [Mac Catalyst 14.0+, macOS 10.1+]
path: preferencepanes
---

# Preference Panes

Integrate your app’s custom preferences into the System Preferences app.

## Overview

Overview Use the Preference Panes framework to integrate your custom system-level preferences into the System Preferences app. You use this framework to implement a preference pane bundle, which contains the custom interface you want to display to the user. You then install your bundle in the appropriate Library/PreferencePanes directory on the user’s system. System Preferences works with your bundle’s custom NSPreferencePane object to manage the presentation of your custom interface to the user. System Preferences loads the view provided by your bundle and delivers lifecycle events to your preference pane object. Use that object to respond to interactions with the controls and views of your interface and to save any settings changes to the user’s defaults database. note: Use preference pane bundles only for settings that must be managed separately from your app. For example, use it to manage settings that are shared between multiple apps in the same suite. Manage app-specific preferences using a custom preferences interface.

## Topics

### Preference Pane Interface

- [NSPreferencePane](preferencepanes/nspreferencepane.md)

### Notifications

- [NSPreferencePrefPaneIsAvailable](foundation/nsnotification/name-swift.struct/nspreferenceprefpaneisavailable.md)
- [NSPreferencePaneDoUnselect](foundation/nsnotification/name-swift.struct/nspreferencepanedounselect.md)
- [NSPreferencePaneCancelUnselect](foundation/nsnotification/name-swift.struct/nspreferencepanecancelunselect.md)
- [NSPreferencePaneSwitchToPane](foundation/nsnotification/name-swift.struct/nspreferencepaneswitchtopane.md)
- [NSPreferencePaneUpdateHelpMenu](foundation/nsnotification/name-swift.struct/nspreferencepaneupdatehelpmenu.md)

### Help Menu Keys

- [NSPrefPaneHelpMenuInfoPListKey](preferencepanes/nsprefpanehelpmenuinfoplistkey.md)
- [NSPrefPaneHelpMenuTitleKey](preferencepanes/nsprefpanehelpmenutitlekey.md)
- [NSPrefPaneHelpMenuAnchorKey](preferencepanes/nsprefpanehelpmenuanchorkey.md)

### Reference

- [PreferencePanes Constants](preferencepanes/preferencepanes-constants.md)