Contents

AppSettings

The declaration to configure app settings.

Declaration

object AppSettings

Properties

NameTypeDescription
AllowedAppSettingsAllowedObject

The dictionary of allowed app settings.

PrivacyAppSettingsPrivacyObject

The dictionary of app settings.

Available: iOS 27+ | iPadOS 27+ | macOS 27+ Allowed scopes: iOS: system | macOS: user

Discussion

Specify com.apple.configuration.app.settings as the declaration type.

Binary Identifier rules

The following combinations of binary identifiers are supported for each key:

  • AllowedBinaries:

    • Either CDHash or TeamID needs to be present.

    • SigningID, PathPrefix, or SigningState may be present.

  • DeniedBinaries

    • Either CDHash or TeamID or SigningID needs to be present.

    • PathPrefix or SigningState may be present.

Privacy Permission Defaults

Privacy permission defaults allow an organization to suggest a set of privacy permissions for use with an app. When set, the app displays a consent prompt listing all the configured defaults. If the user accepts, the device applies those defaults for the app. If the user declines, no defaults are set and the device prompts the user in the normal way when the app requires permission.

The consent prompt only shows permissions that the user hasn’t previously seen, and won’t appear if the user has seen all permissions. The user can choose from one of two options in the prompt:

  • Allow: this option sets the app privacy permissions for the specified sub-systems (camera, microphone, and so on) to “Allow”. The device doesn’t prompt the user when the app uses the sub-system.

  • Not Now: this option ignores the app privacy permission defaults for the specified sub-systems (camera, microphone, and so on). The device prompts the user in the normal way when the app uses the sub-system.

The user can change the app permission privacy settings in Settings.app if they choose.

Only AppKit-based apps on macOS support this feature.

Configuration availability

Allowed in supervised enrollment

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in device enrollment

N/A

Allowed in user enrollment

N/A

Allowed in local enrollment

N/A

Allowed in system scope

iOS, macOS, tvOS, visionOS

Allowed in user scope

macOS, Shared iPad

Apply

Multiple configurations are combined and applied as a single effective configuration

Configuration examples

Topics

Objects

See Also

Configurations