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.

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