Apple Device Policy
Back to Explorer
GitHub YAMLApple Docs

Notifications (com.apple.notificationsettings)

com.apple.notificationsettings

The payload that configures notifications.

iOS(9.3)macOS(10.15)
Branch: release

Settings (13)

SettingTypeRequiredDefaultManual InstallSupported OS
Notification Settings
NotificationSettings
An array of notification settings dictionaries.
1 subkey
arrayrequired—
✓Yes
iOS (9.3+)macOS (10.15+)
└─
Notification Setting
NotificationSettingsItem
11 subkeys
dictionary—
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
App Bundle Identifier
BundleIdentifier
The bundle identifier of the app to which to apply these notification settings. Available in iOS 9.3 and later and macOS 10.15 and later.
stringrequired—
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Enable Notifications
NotificationsEnabled
If `true`, enables notifications for this app. Available in iOS 9.3 and later and macOS 10.15 and later.
booleanoptionaltrue
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Show in Notification Center
ShowInNotificationCenter
If `true`, enables notifications in the notification center for this app. Available in iOS 9.3 and later and macOS 10.15 and later.
booleanoptionaltrue
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Show in Lock Screen
ShowInLockScreen
If `true`, enables notifications on the Lock Screen for this app. Available in iOS 9.3 and later and macOS 10.15 and later.
booleanoptionaltrue
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Alert Type
AlertType
The type of alert for notifications for this app: - `0`: None - `1`: Temporary Banner - `2`: Persistent Banner Available in iOS 9.3 and later and macOS 10.15 and later.
integeroptional1
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Badges Enabled
BadgesEnabled
If `true`, enables badges for this app. Available in iOS 9.3 and later and macOS 10.15 and later.
booleanoptionaltrue
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Sounds Enabled
SoundsEnabled
If `true`, enables sounds for this app.
booleanoptionaltrue
✓Yes
iOS (9.3+)macOS (10.15+)
└─ └─
Show in CarPlay
ShowInCarPlay
If `true`, enables notifications in CarPlay for this app. Available in iOS 12 and later.
booleanoptionaltrue
✓Yes
iOS (12.0+)
└─ └─
Critical Alert Enabled
CriticalAlertEnabled
If `true`, enables critical alerts that can ignore Do Not Disturb and ringer settings for this app. Available in iOS 12 and later and macOS 10.15 and later.
booleanoptionalfalse
✓Yes
iOS (12.0+)
└─ └─
Grouping Type
GroupingType
The type of grouping for notifications for this app: - `0`: Automatic: Group notifications into app-specified groups. - `1`: By app: Group notifications into one group. - `2`: Off: Don't group notifications. Available in iOS 12 and later.
integeroptional0
✓Yes
iOS (12.0+)
└─ └─
Preview Type
PreviewType
The type previews for notifications. This key overrides the value at Settings>Notifications>Show Previews. - `0` - Always: Previews will be shown when the device is locked and unlocked - `1` - When Unlocked: Previews will only be shown when the device is unlocked - `2` - Never: Previews will never be shown Available in iOS 14 and later.
integeroptional—
✓Yes
iOS (14.0+)

Apple MDM & DDM Policy Explorer

Explore the full catalogue of Apple Mobile Device Management (MDM) and Declarative Device Management (DDM) policies for macOS and iOS. Search, filter, and reference policy keys for use with Microsoft Intune, Jamf, or any standards-compliant MDM solution.

Reference: policy categories & common keys

Policy categories

  • Configuration Profile
  • Declarative Configuration
  • Declarative Activation
  • Declarative Asset
  • Declarative Management

Common policy keys

  • com.apple.wifi.managed – Wi-Fi network configuration
  • com.apple.vpn.managed – VPN configuration
  • com.apple.applicationaccess – App and feature restrictions
  • com.apple.security.pkcs1 – Certificate (PKCS#1) payload
  • com.apple.security.pkcs12 – Identity certificate (PKCS#12) payload
  • com.apple.security.scep – SCEP certificate enrolment
  • com.apple.mail.managed – Mail account configuration
  • com.apple.eas.account – Exchange ActiveSync account
  • com.apple.MCX – Managed Client (macOS) preferences
  • com.apple.MCX.FileVault2 – FileVault 2 disk encryption
  • com.apple.dock – macOS Dock configuration
  • com.apple.screensaver – Screensaver configuration
  • com.apple.loginwindow – macOS login window configuration
  • com.apple.systempolicy.managed – Gatekeeper / system policy
  • com.apple.systempreferences – System Preferences pane restrictions
  • com.apple.SoftwareUpdate – Software update behaviour
  • com.apple.TCC.configuration-profile-policy – Privacy Preferences Policy Control (PPPC)
  • com.apple.notificationsettings – Per-app notification settings
  • com.apple.webcontent-filter – Web content filter
  • com.apple.dnsSettings.managed – DNS settings (DoH / DoT)
  • com.apple.relay.managed – Network relay configuration
  • com.apple.extensiblesso – Extensible Single Sign-On
  • com.apple.configuration.passcode.settings – DDM: passcode policy
  • com.apple.configuration.softwareupdate.enforcement.specific – DDM: enforced software update
  • com.apple.configuration.services.configuration-files – DDM: service configuration files
  • com.apple.configuration.management.status-subscriptions – DDM: status subscriptions
  • com.apple.activation.simple – DDM: simple activation predicate
  • com.apple.management.organization-info – DDM: organization information