Dock

Template

The Dock payload is supported on the user channel and, except for AllowDockFixupOverride, on all version of macOS. The key AllowDockFixupOverride is supported on macOS 10.12 and later.

Contents

• Dock
  • Summary
  • Keys
    • orientation
    • position-immutable
    • autohide
    • autohide-immutable
    • minimize-to-application
    • minimize-to-application-immutable
    • magnification
    • magnify-immutable
    • largesize
    • magsize-immutable
    • show-process-indicators
    • launchanim
    • launchanim-immutable
    • mineffect
    • mineffect-immutable
    • tilesize
    • size-immutable
    • AllowDockFixupOverride
    • static-only
    • static-others
    • static-apps
    • contents-immutable

Summary

PayloadType:com.apple.dock Supervised Only:  N/A macOS:N/A macOS Deprecated:  N/A iOS:N/A iOS Deprecated:N/A Highlander:N/A

Keys

orientation

Position

Orientation of the dock.

Type	Default	Required	Regex	iOS	macOS	Supervised
string	N/A	N/A	N/A	N/A	N/A	N/A

Valid Choices

• left
• bottom
• right

position-immutable

Lock Position

If true, the position is locked.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

autohide

Auto Hide

If true, automatically hide and show the dock.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

autohide-immutable

Lock Auto Hide

If true, the Automatically Hide checkbox is disabled.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

minimize-to-application

Minimize to application

If true, enable the minimize-to-application feature.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

minimize-to-application-immutable

Lock Minimize to application

If true, the minimize-to-application checkbox is disabled.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

magnification

Magnification

Set to true to turn on magnification.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

magnify-immutable

Magnification Checkbox Disabled

Set to true to disable the magnification checkbox.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

largesize

Largest Tile Size

Largest tile size in pixels.

Type	Default	Required	Regex	iOS	macOS	Supervised
real	128.0	N/A	N/A	N/A	N/A	N/A

magsize-immutable

Magnification Slider Disabled

Set to true to disable the magnification slider.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A

show-process-indicators

Show process indicators

If true, show the process indicator.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	N/A	N/A

launchanim

Launch Animation

Set to true to use launch animation.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	True	N/A	N/A	N/A	N/A	N/A

launchanim-immutable

Launch Animation Checkbox Disabled

Set to true to disable the launch animation checkbox.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A

mineffect

Minimization Effect

Description not available

Type	Default	Required	Regex	iOS	macOS	Supervised
string	genie	N/A	N/A	N/A	N/A	N/A

Valid Choices

• genie
• scale

mineffect-immutable

Minimization Popup Menu Disabled

Set to true to disable the minimization effect popup.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A

tilesize

Tile Size

The tile size. Values must be in range 16 to 128.

Type	Default	Required	Regex	iOS	macOS	Supervised
real	64.0	N/A	N/A	N/A	N/A	N/A

size-immutable

Tile Size UI Disabled

Set to true to prevent user from changing tile size.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A

MCXDockSpecialFolders can contain any of the valid mcxfolderflag values .. pfmkey:: MCXDockSpecialFolders:mcxfolderflag /_static/manifests/com.apple.dock manifest.plist

AllowDockFixupOverride

AllowDockFixupOverride

If true, use the file in /Library/Preferences/com.apple.dockfixup.plist when a new user or migrated user logs in. The format of this file currently has no documentation. This option has no effect for existing users.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	N/A	N/A	N/A	N/A	10.12	N/A

static-only

Static items only

If true, the device will use the static-apps and static-others dictionaries for the dock and ignore any items in the persistent-apps and persistent-others dictionaries. If false, the contents will be merged with the static items listed first.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A

static-others

Forced Dock Documents

Dock items in the Documents side that cannot be removed from the dock.

Type	Default	Required	Regex	iOS	macOS	Supervised
array	N/A	N/A	N/A	N/A	N/A	N/A

Each item in static-others is a dictionary containing the following keys:

tile-data

file-data

url

static-apps

Forced Dock Applications

Dock items in the Applications side that cannot be removed from the dock.

Type	Default	Required	Regex	iOS	macOS	Supervised
array	N/A	N/A	N/A	N/A	N/A	N/A

Each item in static-apps is a dictionary containing the following keys:

Name	Type	Title	Description	Required
tile-data	n/a	n/a	n/a	n/a
tile-type	string	Tile Type	Type of tile.	n/a

tile-data

Name	Type	Title	Description	Required
label	string	n/a	Label of a dock item.	always
url	string	n/a	For URL tiles, the URL string.	n/a
file-type	integer	File Type	The type of the tile expressed as a number. 3 = directory, 0 = URL, 1 = file	always

file-data

contents-immutable

Changes Disabled

If true, the user cannot remove any item from or add any item to the dock.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	N/A	N/A	N/A	N/A	N/A