Dock

com.apple.dock

The payload that configures the Dock.

macOS 10.7+

Not available with User Enrollment · Only one instance per profile

Configuration Keys (44)

Showing 44 of 44 keys

Key	Type	Description	Default	Range
`static-apps`array Static Apps	array	An array of items located on the Applications side of the Dock that users can't remove from that location.	Default: —	Range: —
`StaticItem`dict	dict	Items that are located on the Documents side of the Dock and cannot be removed from that location.	Default: —	Range: —
`tile-type`string Type required	string	The type of tile.	Default: "file-tile"	Range: File (file-tile)
`tile-data`dict Information required	dict	The information about the Dock item.	Default: —	Range: —
`label`string Label required	string	The label of the Dock item.	Default: —	Range: —
`file-label`string Display Name	string	Display name in the profile GUI of a dock item.	Default: —	Range: —
`file-type`integer Type required	integer	The type of tile.	Default: —	Range: File (1)
`file-data`dict File Data required	dict	The data in a file. For Apple use only.	Default: —	Range: —
`_CFURLString`string Path	string	Path to the application.	Default: —	Range: —
`_CFURLStringType`integer Path Type	integer	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	Default: —	Range: Path (0), File URL (15)
`url`string	string	The URL string.	Default: —	Range: —
`static-others`array Static Others	array	An array of items located on the Documents side of the Dock that users can't remove from that location.	Default: —	Range: —
`StaticItem`dict Static Other	dict	Items that are located on the Documents side of the Dock and cannot be removed from that location.	Default: —	Range: —
`tile-type`string Type required	string	The type of tile.	Default: "file-tile"	Range: File (file-tile), Directory (directory-tile), URL (url-tile)
`tile-data`dict Information required	dict	The information about the Dock item.	Default: —	Range: —
`label`string Label required	string	The label of the Dock item.	Default: —	Range: —
`file-label`string Display Name	string	Display name in the profile GUI of a dock item.	Default: —	Range: —
`url`string URL	string	The URL string.	Default: —	Range: —
`file-type`integer Type required	integer	The type of tile: '0': URL '1': File '3': Directory	Default: —	Range: URL (0), File (1), Directory (3)
`file-data`dict File Data required	dict	The data in a file. For Apple use only.	Default: —	Range: —
`_CFURLString`string Path	string	Path to the file.	Default: —	Range: —
`_CFURLStringType`integer Path Type	integer	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	Default: —	Range: Path (0), File URL (15)
`home directory relative`string Home Directory Relative	string	Path to item relative to the current user's home directory.	Default: —	Range: —
`arrangement`integer Arrangement	integer	Arrangement (sorting) of the directory contents.	Default: 1	Range: Name (1), Date Added (2), Date Modified (3), Date Created (4), Kind (5)
`displayas`integer Display As	integer	Display directory as either a Folder or a Stack.	Default: 2	Range: Folder (1), Stack (2)
`showas`integer Show As	integer	How to show directory contents.	Default: 4	Range: Fan (1), Grid (2), List (3), Automatic (4)
`persistent-apps`array Persistent Apps	array	An array of items located on the Applications side of the Dock that users can remove from the Dock.	Default: —	Range: —
`StaticItem`dict	dict	Items that are located on the Documents side of the Dock and cannot be removed from that location.	Default: —	Range: —
`tile-type`string Type required	string	The type of tile.	Default: "file-tile"	Range: File (file-tile)
`tile-data`dict Information required	dict	The information about the Dock item.	Default: —	Range: —
`label`string Label required	string	The label of the Dock item.	Default: —	Range: —
`file-label`string Display Name	string	Display name in the profile GUI of a dock item.	Default: —	Range: —
`file-type`integer Type required	integer	The type of tile.	Default: —	Range: File (1)
`file-data`dict File Data required	dict	The data in a file. For Apple use only.	Default: —	Range: —
`_CFURLString`string Path	string	Path to the application.	Default: —	Range: —
`_CFURLStringType`integer Path Type	integer	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	Default: —	Range: Path (0), File URL (15)
`url`string	string	The URL string.	Default: —	Range: —
`persistent-others`array Persistent Others	array	An array of items located on the Documents side of the Dock that users can remove from the Dock.	Default: —	Range: —
`StaticItem`dict Static Other	dict	Items that are located on the Documents side of the Dock and cannot be removed from that location.	Default: —	Range: —
`tile-type`string Type required	string	The type of tile.	Default: "file-tile"	Range: File (file-tile), Directory (directory-tile), URL (url-tile)
`tile-data`dict Information required	dict	The information about the Dock item.	Default: —	Range: —
`label`string Label required	string	The label of the Dock item.	Default: —	Range: —
`file-label`string Display Name	string	Display name in the profile GUI of a dock item.	Default: —	Range: —
`url`string URL	string	The URL string.	Default: —	Range: —
`file-type`integer Type required	integer	The type of tile: '0': URL '1': File '3': Directory	Default: —	Range: URL (0), File (1), Directory (3)
`file-data`dict File Data required	dict	The data in a file. For Apple use only.	Default: —	Range: —
`_CFURLString`string Path	string	Path to the file.	Default: —	Range: —
`_CFURLStringType`integer Path Type	integer	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	Default: —	Range: Path (0), File URL (15)
`home directory relative`string Home Directory Relative	string	Path to item relative to the current user's home directory.	Default: —	Range: —
`arrangement`integer Arrangement	integer	Arrangement (sorting) of the directory contents.	Default: 1	Range: Name (1), Date Added (2), Date Modified (3), Date Created (4), Kind (5)
`displayas`integer Display As	integer	Display directory as either a Folder or a Stack.	Default: 2	Range: Folder (1), Stack (2)
`showas`integer Show As	integer	How to show directory contents.	Default: 4	Range: Fan (1), Grid (2), List (3), Automatic (4)
`tilesize`integer Size	integer	The tile size. Values must be in the range from 16 to 128.	Default: 64	Range: 16 – 128
`size-immutable`boolean Size slider disabled	boolean	If 'true', locks the size slider.	Default: false	Range: —
`magnification`boolean Enable magnification	boolean	If 'true', enables magnification.	Default: false	Range: —
`magnify-immutable`boolean Enable magnification checkbox disabled	boolean	If 'true', locks magnification.	Default: false	Range: —
`largesize`integer Magnification	integer	The size of the largest magnification.	Default: 128	Range: 16 – 128
`magsize-immutable`boolean Magnification slider disabled	boolean	If 'true', locks the magnification slider.	Default: false	Range: —
`orientation`string Position on screen	string	The orientation of the Dock.	Default: —	Range: Bottom (bottom), Left (left), Right (right)
`position-immutable`boolean Position on screen buttons disabled	boolean	If 'true', locks the position.	Default: false	Range: —
`mineffect`string Minimize window effect	string	The minimize effect.	Default: "genie"	Range: Genie Effect (genie), Scale Effect (scale)
`mineffect-immutable`boolean Minimize window effect button disabled	boolean	If 'true', locks "Minimize windows using."	Default: false	Range: —
`minimize-to-application`boolean Minimize windows into application icon	boolean	If 'true', enables "Minimize windows into application icon."	Default: false	Range: —
`minintoapp-immutable`boolean Minimize windows into application icon Checkbox Disable macOS 10.14+	boolean	If 'true', disables the "Minimize windows into application icon" checkbox.	Default: false	Range: —
`launchanim`boolean Animate opening applications	boolean	If 'true', enables "Animate opening applications."	Default: false	Range: —
`launchanim-immutable`boolean Animate opening applications checkbox disabled	boolean	If 'true', locks "Animate opening applications."	Default: false	Range: —
`autohide`boolean Automatically hide and show the Dock	boolean	If 'true', enables "Automatically hide and show the Dock."	Default: false	Range: —
`autohide-immutable`boolean Automatically hide and show the Dock checkbox disabled	boolean	If 'true', locks "Automatically hide."	Default: false	Range: —
`autohide-delay`real Show delay	real	Delay in seconds before a hidden Dock is shown.	Default: 0.2	Range: —
`autohide-time-modifier`real Show and hide animation duration	real	Duration in seconds of Dock show and hide sliding animations.	Default: 0.5	Range: —
`show-process-indicators`boolean Show indicators for open applications	boolean	If true, shows the process indicator.	Default: false	Range: —
`show-recents`boolean Show recent applications in Dock macOS 10.14+	boolean	If 'true', enables "Show recent items."	Default: false	Range: —
`show-recent-count`integer Number of recent applications	integer	Controls the number of items shown in the recent apps area of the dock.	Default: 3	Range: —
`static-only`boolean Remove non-static apps and documents from Dock	boolean	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.	Default: false	Range: —
`contents-immutable`boolean Prevent modifying items in Dock	boolean	If 'true', disables changes to the Dock.	Default: false	Range: —
`AllowDockFixupOverride`boolean Allow DockFixup override macOS 10.12+	boolean	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.	Default: false	Range: —
`MCXDockSpecialFolders`array Managed Client Special Folders	array	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.	Default: —	Range: —
`MCXDockSpecialFoldersItems`string Folder Flag	string	Flag for the folder to be added by Managed Client.	Default: —	Range: My apps (AddDockMCXMyApplicationsFolder), Documents (AddDockMCXDocumentsFolder), Shared Items (AddDockMCXSharedFolder), Network home (AddDockMCXOriginalNetworkHomeFolder)
`wvous-tl-corner`integer Top Left Hot Corner Action	integer	Action to be taken when the pointer enters the top left corner of the screen	Default: 0	Range: Start Screen Saver (5), Disable Screen Saver (6), Mission Control (2), Application Windows (3), Desktop (4), Dashboard (removed from macOS 10.15) (7), Notification Center (12), Launchpad (11), Quick Note (introduced on macOS 12.0) (14), Put Display to Sleep (10), Lock Screen (13), No Action (0)
`wvous-tl-modifier`integer Top Left Hot Corner Modifier	integer	Modifier keys required to activate the top left hot corner	Default: 0	Range: None (0), Command (1048576), Command+Option (1572864), Command+Option+Control (1835008), Command+Option+Control+Shift (1966080), Command+Option+Shift (1703936), Command+Control (1310720), Command+Control+Shift (1441792), Command+Shift (1179648), Option (524288), Option+Control (786432), Option+Control+Shift (917504), Option+Shift (655360), Control (262144), Control+Shift (393216), Shift (131072)
`wvous-tr-corner`integer Top Right Hot Corner Action	integer	Action to be taken when the pointer enters the top right corner of the screen	Default: 0	Range: Start Screen Saver (5), Disable Screen Saver (6), Mission Control (2), Application Windows (3), Desktop (4), Dashboard (removed from macOS 10.15) (7), Notification Center (12), Launchpad (11), Quick Note (introduced on macOS 12.0) (14), Put Display to Sleep (10), Lock Screen (13), No Action (0)
`wvous-tr-modifier`integer Top Right Hot Corner Modifier	integer	Modifier keys required to activate the top right hot corner	Default: 0	Range: None (0), Command (1048576), Command+Option (1572864), Command+Option+Control (1835008), Command+Option+Control+Shift (1966080), Command+Option+Shift (1703936), Command+Control (1310720), Command+Control+Shift (1441792), Command+Shift (1179648), Option (524288), Option+Control (786432), Option+Control+Shift (917504), Option+Shift (655360), Control (262144), Control+Shift (393216), Shift (131072)
`wvous-bl-corner`integer Bottom Left Hot Corner Action	integer	Action to be taken when the pointer enters the bottom left corner of the screen	Default: 0	Range: Start Screen Saver (5), Disable Screen Saver (6), Mission Control (2), Application Windows (3), Desktop (4), Dashboard (removed from macOS 10.15) (7), Notification Center (12), Launchpad (11), Quick Note (introduced on macOS 12.0) (14), Put Display to Sleep (10), Lock Screen (13), No Action (0)
`wvous-bl-modifier`integer Bottom Left Hot Corner Modifier	integer	Modifier keys required to activate the bottom left hot corner	Default: 0	Range: None (0), Command (1048576), Command+Option (1572864), Command+Option+Control (1835008), Command+Option+Control+Shift (1966080), Command+Option+Shift (1703936), Command+Control (1310720), Command+Control+Shift (1441792), Command+Shift (1179648), Option (524288), Option+Control (786432), Option+Control+Shift (917504), Option+Shift (655360), Control (262144), Control+Shift (393216), Shift (131072)
`wvous-br-corner`integer Bottom Right Hot Corner Action	integer	Action to be taken when the pointer enters the bottom right corner of the screen	Default: 0	Range: Start Screen Saver (5), Disable Screen Saver (6), Mission Control (2), Application Windows (3), Desktop (4), Dashboard (removed from macOS 10.15) (7), Notification Center (12), Launchpad (11), Quick Note (introduced on macOS 12.0) (14), Put Display to Sleep (10), Lock Screen (13), No Action (0)
`wvous-br-modifier`integer Bottom Right Hot Corner Modifier	integer	Modifier keys required to activate the bottom right hot corner	Default: 0	Range: None (0), Command (1048576), Command+Option (1572864), Command+Option+Control (1835008), Command+Option+Control+Shift (1966080), Command+Option+Shift (1703936), Command+Control (1310720), Command+Control+Shift (1441792), Command+Shift (1179648), Option (524288), Option+Control (786432), Option+Control+Shift (917504), Option+Shift (655360), Control (262144), Control+Shift (393216), Shift (131072)
`windowtabbing`string Prefer tabs when opening documents macOS 10.15+	string	Set the "Prefer tabs when opening documents" to the provided value.	Default: —	Range: Manual (manual), Always (always), Fullscreen (fullscreen)
`windowtabbing-immutable`boolean Prevent changing tabs preference macOS 10.12+	boolean	If 'true', disables "Prefer tabs when opening documents" checkbox.	Default: false	Range: —
`dblclickbehavior`string Doubleclick behavior macOS 10.15+	string	The behavior when the window's title bar is double-clicked.	Default: —	Range: Minimize (minimize), Maximize (maximize), None (none)
`dblclickbehavior-immutable`boolean Prevent changing doubleclick behavior macOS 10.14+	boolean	If 'true', locks "Double-click a window's title bar."	Default: false	Range: —
`showindicators-immutable`boolean Prevent changing indicators display	boolean	If 'true', locks "Show indicators."	Default: false	Range: —
`showrecents-immutable`boolean Prevent shanging recents display macOS 10.15+	boolean	If 'true', disables "Show recent applications" checkbox.	Default: false	Range: —
`PayloadEnabled`boolean Payload Enabled	boolean	Whether this Dock configuration payload is enabled and should be applied to the system.	Default: true	Range: —