Contents

Dock

The payload that configures the Dock.

Declaration

object Dock

Properties

NameTypeDescription
AllowDockFixupOverrideboolean

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.

Available: macOS 10.12+

autohideboolean

If true, enables “Automatically hide and show the Dock.”

autohide-immutableboolean

If true, locks “Automatically hide.”

contents-immutableboolean

If true, disables changes to the Dock.

dblclickbehaviorstring

The behavior when the window’s title bar is double-clicked.

Available: macOS 10.15+

dblclickbehavior-immutableboolean

If true, locks “Double-click a window’s title bar.”

Available: macOS 10.14+

largesizeinteger

The size of the largest magnification.

launchanimboolean

If true, enables “Animate opening applications.”

launchanim-immutableboolean

If true, locks “Animate opening applications.”

magnificationboolean

If true, enables magnification.

magnify-immutableboolean

If true, locks magnification.

magsize-immutableboolean

If true, locks the magnification slider.

MCXDockSpecialFolders[string]

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.

mineffectstring

The minimize effect.

mineffect-immutableboolean

If true, locks “Minimize windows using.”

minimize-to-applicationboolean

If true, enables “Minimize windows into application icon.”

minintoapp-immutableboolean

If true, disables the “Minimize windows into application icon” checkbox.

Available: macOS 10.14+

orientationstring

The orientation of the Dock.

persistent-apps[Dock.StaticItem]

An array of items located on the Applications side of the Dock that can be removed from the Dock.

persistent-others[Dock.StaticItem]

An array of items located on the Documents side of the Dock that can be removed from the Dock.

position-immutableboolean

If true, locks the position.

show-process-indicatorsboolean

If true, shows the process indicator.

show-recentsboolean

If true, enables “Show recent items.”

Available: macOS 10.14+

showindicators-immutableboolean

If true, locks “Show indicators.”

showrecents-immutableboolean

If true, disables “Show recent applications” checkbox.

Available: macOS 10.15+

size-immutableboolean

If true, locks the size slider.

static-apps[Dock.StaticItem]

An array of items located on the Applications side of the Dock and cannot be removed from that location.

static-onlyboolean

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.

static-others[Dock.StaticItem]

An array of items located on the Documents side of the Dock and cannot be removed from that location.

tilesizeinteger

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

windowtabbingstring

Set the “Prefer tabs when opening documents” to the provided value.

Available: macOS 10.15+

windowtabbing-immutableboolean

If true, disables “Prefer tabs when opening documents” checkbox.

Available: macOS 10.12+

Discussion

Specify com.apple.dock as the payload type.

Profile availability

Device channel

macOS

User channel

macOS

Allow manual install

macOS

Requires supervision

N/A

Requires user-approved MDM

N/A

Allowed in user enrollment

N/A

Allow multiple payloads

N/A

Profile example

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <dict>
            <key>tilesize</key>
            <integer>40</integer>
            <key>size-immutable</key>
            <true/>
            <key>magnification</key>
            <true/>
            <key>magnify-immutable</key>
            <true/>
            <key>largesize</key>
            <integer>100</integer>
            <key>magsize-immutable</key>
            <true/>
            <key>orientation</key>
            <string>left</string>
            <key>position-immutable</key>
            <true/>
            <key>mineffect</key>
            <string>genie</string>
            <key>mineffect-immutable</key>
            <true/>
            <key>windowtabbing</key>
            <string>manual</string>
            <key>windowtabbing-immutable</key>
            <true/>
            <key>dblclickbehavior</key>
            <string>maximize</string>
            <key>dblclickbehavior-immutable</key>
            <true/>
            <key>minimize-to-application</key>
            <true/>
            <key>minintoapp-immutable</key>
            <true/>
            <key>launchanim</key>
            <true/>
            <key>launchanim-immutable</key>
            <true/>
            <key>autohide</key>
            <false/>
            <key>autohide-immutable</key>
            <true/>
            <key>show-process-indicators</key>
            <false/>
            <key>showindicators-immutable</key>
            <true/>
            <key>show-recents</key>
            <false/>
            <key>showrecents-immutable</key>
            <true/>
            <key>PayloadIdentifier</key>
            <string>com.example.mydockpayload</string>
            <key>PayloadType</key>
            <string>com.apple.dock</string>
            <key>PayloadUUID</key>
            <string>8d443602-52f2-48ff-aaa9-35b16c7c54c9</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
        </dict>
    </array>
    <key>PayloadDisplayName</key>
    <string>Dock</string>
    <key>PayloadIdentifier</key>
    <string>com.example.myprofile</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>c139d3e0-5468-43b0-90bf-5e05b2e8cd6f</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>
</plist>

Topics

Objects

See Also

User experience