The payload that configures the Home Screen layout.
| Setting | Type | Required | Default | Manual Install | Supported OS |
|---|---|---|---|---|---|
Dock Dock An array of dictionaries, each of which must conform to the icon dictionary format. If this key isn't present, the user's Dock is empty. 1 subkey | array | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ IconItem IconItem An array of dictionaries that conform to the icon dictionary format. 5 subkeys | dictionary | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | |
└─ └─ Type Type The type of the Dock item. | string | required | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ DisplayName DisplayName The human-readable string shown to the user. This setting is valid only if the type is `Folder`. | string | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ BundleID BundleID The bundle identifier of the app. The device requires this setting if the type is `Application`. | string | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ Pages Pages An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`. 1 subkey | array | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ └─ PagesItem PagesItem 1 subkey | array | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (deeply nested - 1 subkey). See Apple's documentation for the complete structure. | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | ||
└─ └─ URL URL The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined.
Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip. | string | optional | — | ✓Yes | iOS (11.3+) |
Pages Pages An array of arrays of dictionaries, each of which must conform to the icon dictionary format. 1 subkey | array | required | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ PagesItem PagesItem 1 subkey | array | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | |
└─ └─ IconItem IconItem An array of dictionaries that conform to the icon dictionary format. 5 subkeys | dictionary | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | |
└─ └─ └─ Type Type The type of the Dock item. | string | required | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ └─ DisplayName DisplayName The human-readable string shown to the user. This setting is valid only if the type is `Folder`. | string | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ └─ BundleID BundleID The bundle identifier of the app. The device requires this setting if the type is `Application`. | string | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ └─ Pages Pages An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`. 1 subkey | array | optional | — | ✓Yes | iOS (9.3+)tvOS (11.0+) |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (recursive structure - refers back to Pages). See Apple's documentation for the complete structure. | — | ✓Yes | iOS (9.3+)tvOS (11.0+) | ||
└─ └─ └─ URL URL The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined.
Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip. | string | optional | — | ✓Yes | iOS (11.3+) |
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.
com.apple.wifi.managed – Wi-Fi network configurationcom.apple.vpn.managed – VPN configurationcom.apple.applicationaccess – App and feature restrictionscom.apple.security.pkcs1 – Certificate (PKCS#1) payloadcom.apple.security.pkcs12 – Identity certificate (PKCS#12) payloadcom.apple.security.scep – SCEP certificate enrolmentcom.apple.mail.managed – Mail account configurationcom.apple.eas.account – Exchange ActiveSync accountcom.apple.MCX – Managed Client (macOS) preferencescom.apple.MCX.FileVault2 – FileVault 2 disk encryptioncom.apple.dock – macOS Dock configurationcom.apple.screensaver – Screensaver configurationcom.apple.loginwindow – macOS login window configurationcom.apple.systempolicy.managed – Gatekeeper / system policycom.apple.systempreferences – System Preferences pane restrictionscom.apple.SoftwareUpdate – Software update behaviourcom.apple.TCC.configuration-profile-policy – Privacy Preferences Policy Control (PPPC)com.apple.notificationsettings – Per-app notification settingscom.apple.webcontent-filter – Web content filtercom.apple.dnsSettings.managed – DNS settings (DoH / DoT)com.apple.relay.managed – Network relay configurationcom.apple.extensiblesso – Extensible Single Sign-Oncom.apple.configuration.passcode.settings – DDM: passcode policycom.apple.configuration.softwareupdate.enforcement.specific – DDM: enforced software updatecom.apple.configuration.services.configuration-files – DDM: service configuration filescom.apple.configuration.management.status-subscriptions – DDM: status subscriptionscom.apple.activation.simple – DDM: simple activation predicatecom.apple.management.organization-info – DDM: organization information