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. The key show-recents is supported on macOS 10.14 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
    • 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:True

Keys

orientation

Position on screen

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

Position on screen buttons disabled

Prevent user from changing position.

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

autohide

Automatically hide and show the Dock

Set to true to 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

Automatically hide and show the Dock checkbox disabled

Prevent user from changing the automatically hide and show the dock setting.

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

minimize-to-application

Minimize windows into application icon

Set to true to minimize windows into application icons.

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

minimize-to-application-immutable

Minimize windows into application icon Checkbox Disable

Prevent user from changing the minimize windows into application icon setting.

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

magnification

Enable 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

Enable magnification checkbox disabled

Prevent user from changing the enable magnification setting.

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

largesize

Magnification

Largest magnification tile size in pixels.

Type	Default	Required	Regex	iOS	macOS	Supervised
integer	128	N/A	N/A	N/A	N/A	N/A

magsize-immutable

Magnification slider disabled

Prevent user from changing magnification size.

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

show-process-indicators

Show indicators for open applications

Set to true to show an indicator below the application icon when an application is running.

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

launchanim

Animate opening applications

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

Animate opening applications checkbox disabled

Prevent user from changing the animate opening applications setting.

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

mineffect

Minimize window effect

Transition effect to use when minimizing applications to the Dock.

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

Valid Choices

• Genie Effect
• Scale Effect

mineffect-immutable

Minimize window effect button disabled

Prevent user from changing the minimization setting.

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

tilesize

Size

The tile size in pixels.

Type	Default	Required	Regex	iOS	macOS	Supervised
integer	64	N/A	N/A	N/A	N/A	N/A

size-immutable

Size slider disabled

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/ProfileManifests/Manifests/ManifestsApple/com.apple.dock.plist

AllowDockFixupOverride

Allow DockFixup override

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

Merge with User’s Dock

Whether these settings will merge with the user’s existing Dock settings.

Type	Default	Required	Regex	iOS	macOS	Supervised
boolean	False	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

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

tile-data

file-data

contents-immutable

Allow modifying items in Dock

Prevent user from removing any item from or adding any item to the dock.

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