The payload that configures the Dock.
| Setting | Type | Required | Default | Manual Install | Supported OS |
|---|---|---|---|---|---|
tilesize tilesize The tile size. Values must be in the range from 16 to 128. Range: 16 - 128 | integer | optional | — | ✓Yes | macOS (10.7+) |
size-immutable size-immutable If `true`, locks the size slider. | boolean | optional | false | ✓Yes | macOS (10.7+) |
magnification magnification If `true`, enables magnification. | boolean | optional | false | ✓Yes | macOS (10.7+) |
magnify-immutable magnify-immutable If `true`, locks magnification. | boolean | optional | false | ✓Yes | macOS (10.7+) |
largesize largesize The size of the largest magnification. Range: 16 - 128 | integer | optional | — | ✓Yes | macOS (10.7+) |
magsize-immutable magsize-immutable If `true`, locks the magnification slider. | boolean | optional | false | ✓Yes | macOS (10.7+) |
orientation orientation The orientation of the Dock. | string | optional | — | ✓Yes | macOS (10.7+) |
position-immutable position-immutable If `true`, locks the position. | boolean | optional | false | ✓Yes | macOS (10.7+) |
mineffect mineffect The minimize effect. | string | optional | — | ✓Yes | macOS (10.7+) |
mineffect-immutable mineffect-immutable If `true`, locks "Minimize windows using." | boolean | optional | false | ✓Yes | macOS (10.7+) |
windowtabbing windowtabbing Set the "Prefer tabs when opening documents" to the provided value. | string | optional | — | ✓Yes | macOS (10.15+) |
windowtabbing-immutable windowtabbing-immutable If `true`, disables "Prefer tabs when opening documents" checkbox. | boolean | optional | false | ✓Yes | macOS (10.12+) |
dblclickbehavior dblclickbehavior The behavior when the window's title bar is double-clicked. | string | optional | — | ✓Yes | macOS (10.15+) |
dblclickbehavior-immutable dblclickbehavior-immutable If `true`, locks "Double-click a window's title bar." | boolean | optional | false | ✓Yes | macOS (10.14+) |
minimize-to-application minimize-to-application If `true`, enables "Minimize windows into application icon." | boolean | optional | false | ✓Yes | macOS (10.7+) |
minintoapp-immutable minintoapp-immutable If `true`, disables the "Minimize windows into application icon" checkbox. | boolean | optional | false | ✓Yes | macOS (10.14+) |
launchanim launchanim If `true`, enables "Animate opening applications." | boolean | optional | false | ✓Yes | macOS (10.7+) |
launchanim-immutable launchanim-immutable If `true`, locks "Animate opening applications." | boolean | optional | false | ✓Yes | macOS (10.7+) |
autohide autohide If `true`, enables "Automatically hide and show the Dock." | boolean | optional | false | ✓Yes | macOS (10.7+) |
autohide-immutable autohide-immutable If `true`, locks "Automatically hide." | boolean | optional | false | ✓Yes | macOS (10.7+) |
show-process-indicators show-process-indicators If true, shows the process indicator. | boolean | optional | false | ✓Yes | macOS (10.7+) |
showindicators-immutable showindicators-immutable If `true`, locks "Show indicators." | boolean | optional | false | ✓Yes | macOS (10.7+) |
show-recents show-recents If `true`, enables "Show recent items." | boolean | optional | false | ✓Yes | macOS (10.14+) |
showrecents-immutable showrecents-immutable If `true`, disables "Show recent applications" checkbox. | boolean | optional | false | ✓Yes | macOS (10.15+) |
contents-immutable contents-immutable If `true`, disables changes to the Dock. | boolean | optional | false | ✓Yes | macOS (10.7+) |
MCXDockSpecialFolders MCXDockSpecialFolders One or more special folders that the device may create at user login time and place in the Dock.
The "My Applications" item is only used for Simple Finder environments. The "Original Network Home" item is only used for mobile account users. 1 subkey | array | optional | — | ✓Yes | macOS (10.7+) |
└─ MCXDockSpecialFoldersItems MCXDockSpecialFoldersItems | string | — | ✓Yes | macOS (10.7+) | |
AllowDockFixupOverride AllowDockFixupOverride If `true`, use the file in `/Library/Preferences/com.apple.dockfixup.plist` when a new user or migrated user logs in. This option has no effect for existing users. Only available on the device channel. | boolean | optional | false | ✓Yes | macOS (10.12+) |
static-only static-only If `true`, uses the `static-apps` and `static-others` dictionaries for the Dock and ignores any items in the `persistent-apps` and `persistent-others` dictionaries. If `false`, the contents are merged with the static items listed first. | boolean | optional | false | ✓Yes | macOS (10.7+) |
static-others static-others An array of items located on the Documents side of the Dock that users can't remove from that location. 1 subkey | array | optional | — | ✓Yes | macOS (10.7+) |
└─ StaticItem StaticItem Items that are located on the Documents side of the Dock and cannot be removed from that location. 2 subkeys | dictionary | — | ✓Yes | macOS (10.7+) | |
└─ └─ tile-data tile-data The information about the Dock item. 4 subkeys | dictionary | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ label label The label of the Dock item. | string | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ url url The URL string. | string | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-type file-type The type of tile:
- `0`: URL
- `1`: File
- `3`: Directory | integer | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-data file-data The data in a file. For Apple use only. 1 subkey | dictionary | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (deeply nested - 1 subkey). See Apple's documentation for the complete structure. | — | ✓Yes | macOS (10.7+) | ||
└─ └─ tile-type tile-type The type of tile. | string | required | — | ✓Yes | macOS (10.7+) |
static-apps static-apps An array of items located on the Applications side of the Dock that users can't remove from that location. 1 subkey | array | optional | — | ✓Yes | macOS (10.7+) |
└─ StaticItem StaticItem Items that are located on the Documents side of the Dock and cannot be removed from that location. 2 subkeys | dictionary | — | ✓Yes | macOS (10.7+) | |
└─ └─ tile-data tile-data The information about the Dock item. 4 subkeys | dictionary | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ label label The label of the Dock item. | string | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ url url The URL string. | string | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-type file-type The type of tile:
- `0`: URL
- `1`: File
- `3`: Directory | integer | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-data file-data The data in a file. For Apple use only. 1 subkey | dictionary | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (deeply nested - 1 subkey). See Apple's documentation for the complete structure. | — | ✓Yes | macOS (10.7+) | ||
└─ └─ tile-type tile-type The type of tile. | string | required | — | ✓Yes | macOS (10.7+) |
persistent-apps persistent-apps An array of items located on the Applications side of the Dock that users can remove from the Dock. 1 subkey | array | optional | — | ✓Yes | macOS (10.7+) |
└─ StaticItem StaticItem Items that are located on the Documents side of the Dock and cannot be removed from that location. 2 subkeys | dictionary | — | ✓Yes | macOS (10.7+) | |
└─ └─ tile-data tile-data The information about the Dock item. 4 subkeys | dictionary | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ label label The label of the Dock item. | string | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ url url The URL string. | string | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-type file-type The type of tile:
- `0`: URL
- `1`: File
- `3`: Directory | integer | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-data file-data The data in a file. For Apple use only. 1 subkey | dictionary | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (deeply nested - 1 subkey). See Apple's documentation for the complete structure. | — | ✓Yes | macOS (10.7+) | ||
└─ └─ tile-type tile-type The type of tile. | string | required | — | ✓Yes | macOS (10.7+) |
persistent-others persistent-others An array of items located on the Documents side of the Dock that users can remove from the Dock. 1 subkey | array | optional | — | ✓Yes | macOS (10.7+) |
└─ StaticItem StaticItem Items that are located on the Documents side of the Dock and cannot be removed from that location. 2 subkeys | dictionary | — | ✓Yes | macOS (10.7+) | |
└─ └─ tile-data tile-data The information about the Dock item. 4 subkeys | dictionary | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ label label The label of the Dock item. | string | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ url url The URL string. | string | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-type file-type The type of tile:
- `0`: URL
- `1`: File
- `3`: Directory | integer | required | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ file-data file-data The data in a file. For Apple use only. 1 subkey | dictionary | optional | — | ✓Yes | macOS (10.7+) |
└─ └─ └─ └─ [Structure continues recursively] ↻ This structure continues with 1 subkey (deeply nested - 1 subkey). See Apple's documentation for the complete structure. | — | ✓Yes | macOS (10.7+) | ||
└─ └─ tile-type tile-type The type of tile. | string | required | — | ✓Yes | macOS (10.7+) |
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