Dock

com.apple.dock

The payload that configures the Dock.

macOS

macOS 10.7+combined

Configuration Keys (41)

Key	Type	Title	Description	Default	Range
`static-apps`	array	Static Apps	An array of items located on the Applications side of the Dock and cannot be removed from that location.	—	—
`static-others`	array	Static Others	An array of items located on the Documents side of the Dock and cannot be removed from that location.	—	—
`persistent-apps`	array	Persistent Apps	An array of items located on the Applications side of the Dock that can be removed from the Dock.	—	—
`persistent-others`	array	Persistent Others	An array of items located on the Documents side of the Dock that can be removed from the Dock.	—	—
`tilesize`	integer	Size	The tile size. Values must be in the range from 16 to 128.	64
`size-immutable`	boolean	Size slider disabled	If 'true', locks the size slider.	false	—
`magnification`	boolean	Enable magnification	If 'true', enables magnification.	false	—
`magnify-immutable`	boolean	Enable magnification checkbox disabled	If 'true', locks magnification.	false	—
`largesize`	integer	Magnification	The size of the largest magnification.	128
`magsize-immutable`	boolean	Magnification slider disabled	If 'true', locks the magnification slider.	false	—
`orientation`	string	Position on screen	The orientation of the Dock.	—
`position-immutable`	boolean	Position on screen buttons disabled	If 'true', locks the position.	false	—
`mineffect`	string	Minimize window effect	The minimize effect.	"genie"
`mineffect-immutable`	boolean	Minimize window effect button disabled	If 'true', locks "Minimize windows using."	false	—
`minimize-to-application`	boolean	Minimize windows into application icon	If 'true', enables "Minimize windows into application icon."	false	—
`minintoapp-immutable`	boolean	Minimize windows into application icon Checkbox Disable	If 'true', disables the "Minimize windows into application icon" checkbox.	false	—
`launchanim`	boolean	Animate opening applications	If 'true', enables "Animate opening applications."	false	—
`launchanim-immutable`	boolean	Animate opening applications checkbox disabled	If 'true', locks "Animate opening applications."	false	—
`autohide`	boolean	Automatically hide and show the Dock	If 'true', enables "Automatically hide and show the Dock."	false	—
`autohide-immutable`	boolean	Automatically hide and show the Dock checkbox disabled	If 'true', locks "Automatically hide."	false	—
`show-process-indicators`	boolean	Show indicators for open applications	If true, shows the process indicator.	false	—
`show-recents`	boolean	Show recent applications in Dock	If 'true', enables "Show recent items."	false	—
`show-recent-count`	integer	Number of recent applications	Controls the number of items shown in the recent apps area of the dock.	3	—
`static-only`	boolean	Remove non-static apps and documents from Dock	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.	false	—
`contents-immutable`	boolean	Prevent modifying items in Dock	If 'true', disables changes to the Dock.	false	—
`AllowDockFixupOverride`	boolean	Allow DockFixup override	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.	false	—
`MCXDockSpecialFolders`	array	Managed Client Special Folders	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.	—	—
`wvous-tl-corner`	integer	Top Left Hot Corner Action	Action to be taken when the pointer enters the top left corner of the screen	0
`wvous-tl-modifier`	integer	Top Left Hot Corner Modifier	Modifier keys required to activate the top left hot corner	0
`wvous-tr-corner`	integer	Top Right Hot Corner Action	Action to be taken when the pointer enters the top right corner of the screen	0
`wvous-tr-modifier`	integer	Top Right Hot Corner Modifier	Modifier keys required to activate the top right hot corner	0
`wvous-bl-corner`	integer	Bottom Left Hot Corner Action	Action to be taken when the pointer enters the bottom left corner of the screen	0
`wvous-bl-modifier`	integer	Bottom Left Hot Corner Modifier	Modifier keys required to activate the bottom left hot corner	0
`wvous-br-corner`	integer	Bottom Right Hot Corner Action	Action to be taken when the pointer enters the bottom right corner of the screen	0
`wvous-br-modifier`	integer	Bottom Right Hot Corner Modifier	Modifier keys required to activate the bottom right hot corner	0
`windowtabbing`	string	Prefer tabs when opening documents	Set the "Prefer tabs when opening documents" to the provided value.	—
`windowtabbing-immutable`	boolean	Prevent changing tabs preference	If 'true', disables "Prefer tabs when opening documents" checkbox.	false	—
`dblclickbehavior`	string	Doubleclick behavior	The behavior when the window's title bar is double-clicked.	—
`dblclickbehavior-immutable`	boolean	Prevent changing doubleclick behavior	If 'true', locks "Double-click a window's title bar."	false	—
`showindicators-immutable`	boolean	Prevent changing indicators display	If 'true', locks "Show indicators."	false	—
`showrecents-immutable`	boolean	Prevent shanging recents display	If 'true', disables "Show recent applications" checkbox.	false	—
`StaticItem`	dict	—	—	—	—
`tile-type`required	string	Type	The type of tile.	"file-tile"
`tile-data`required	dict	Information	The information about the Dock item.	—	—
`label`required	string	Label	The label of the Dock item.	—	—
`file-label`	string	Display Name	Display name in the profile GUI of a dock item.	—	—
`file-type`required	integer	Type	The type of tile.	—
`file-data`required	dict	File Data	The data in a file. For Apple use only.	—	—
`url`	string	—	The URL string.	—	—
`_CFURLString`	string	Path	Path to the application.	—	—
`_CFURLStringType`	integer	Path Type	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	—
`StaticItem`	dict	Static Other	Items that are located on the Documents side of the Dock and cannot be removed from that location.	—	—
`tile-type`required	string	Type	The type of tile.	"file-tile"
`tile-data`required	dict	Information	The information about the Dock item.	—	—
`label`required	string	Label	The label of the Dock item.	—	—
`file-label`	string	Display Name	Display name in the profile GUI of a dock item.	—	—
`url`	string	URL	The URL string.	—	—
`file-type`required	integer	Type	The type of tile: - '0': URL - '1': File - '3': Directory	—
`file-data`required	dict	File Data	The data in a file. For Apple use only.	—	—
`home directory relative`	string	Home Directory Relative	Path to item relative to the current user's home directory.	—	—
`arrangement`	integer	Arrangement	Arrangement (sorting) of the directory contents.	1
`displayas`	integer	Display As	Display directory as either a Folder or a Stack.	2
`showas`	integer	Show As	How to show directory contents.	4
`_CFURLString`	string	Path	Path to the file.	—	—
`_CFURLStringType`	integer	Path Type	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	—
`StaticItem`	dict	—	—	—	—
`tile-type`required	string	Type	The type of tile.	"file-tile"
`tile-data`required	dict	Information	The information about the Dock item.	—	—
`label`required	string	Label	The label of the Dock item.	—	—
`file-label`	string	Display Name	Display name in the profile GUI of a dock item.	—	—
`file-type`required	integer	Type	The type of tile.	—
`file-data`required	dict	File Data	The data in a file. For Apple use only.	—	—
`url`	string	—	The URL string.	—	—
`_CFURLString`	string	Path	Path to the application.	—	—
`_CFURLStringType`	integer	Path Type	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	—
`StaticItem`	dict	Static Other	Items that are located on the Documents side of the Dock and cannot be removed from that location.	—	—
`tile-type`required	string	Type	The type of tile.	"file-tile"
`tile-data`required	dict	Information	The information about the Dock item.	—	—
`label`required	string	Label	The label of the Dock item.	—	—
`file-label`	string	Display Name	Display name in the profile GUI of a dock item.	—	—
`url`	string	URL	The URL string.	—	—
`file-type`required	integer	Type	The type of tile: - '0': URL - '1': File - '3': Directory	—
`file-data`required	dict	File Data	The data in a file. For Apple use only.	—	—
`home directory relative`	string	Home Directory Relative	Path to item relative to the current user's home directory.	—	—
`arrangement`	integer	Arrangement	Arrangement (sorting) of the directory contents.	1
`displayas`	integer	Display As	Display directory as either a Folder or a Stack.	2
`showas`	integer	Show As	How to show directory contents.	4
`_CFURLString`	string	Path	Path to the file.	—	—
`_CFURLStringType`	integer	Path Type	Path type. 0 = /Path/to/item, 15 = file://Path/to/item	—
`MCXDockSpecialFoldersItems`	string	Folder Flag	Flag for the folder to be added by Managed Client.	—