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 may be created at user login time and placed 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. Available in macOS 10.12 and later. 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 and cannot be removed 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 and cannot be removed 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 can be removed 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 can be removed 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+) |
