---
title: Dock
framework: devicemanagement
role: symbol
role_heading: Device Management Profile
path: devicemanagement/dock
---

# Dock

The payload that configures the Dock.

## Declaration

```data
object Dock
```

## Properties

AllowDockFixupOverride: 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+ autohide: If true, enables “Automatically hide and show the Dock.” autohide-immutable: If true, locks “Automatically hide.” contents-immutable: If true, disables changes to the Dock. dblclickbehavior: The behavior when the window’s title bar is double-clicked. Available: macOS 10.15+ dblclickbehavior-immutable: If true, locks “Double-click a window’s title bar.” Available: macOS 10.14+ largesize: The size of the largest magnification. launchanim: If true, enables “Animate opening applications.” launchanim-immutable: If true, locks “Animate opening applications.” magnification: If true, enables magnification. magnify-immutable: If true, locks magnification. magsize-immutable: If true, locks the magnification slider. MCXDockSpecialFolders: 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. mineffect: The minimize effect. mineffect-immutable: If true, locks “Minimize windows using.” minimize-to-application: If true, enables “Minimize windows into application icon.” minintoapp-immutable: If true, disables the “Minimize windows into application icon” checkbox. Available: macOS 10.14+ orientation: The orientation of the Dock. persistent-apps: An array of items located on the Applications side of the Dock that can be removed from the Dock. persistent-others: An array of items located on the Documents side of the Dock that can be removed from the Dock. position-immutable: If true, locks the position. show-process-indicators: If true, shows the process indicator. show-recents: If true, enables “Show recent items.” Available: macOS 10.14+ showindicators-immutable: If true, locks “Show indicators.” showrecents-immutable: If true, disables “Show recent applications” checkbox. Available: macOS 10.15+ size-immutable: If true, locks the size slider. static-apps: An array of items located on the Applications side of the Dock and cannot be removed from that location. static-only: 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: An array of items located on the Documents side of the Dock and cannot be removed from that location. tilesize: The tile size. Values must be in the range from 16 to 128. windowtabbing: Set the “Prefer tabs when opening documents” to the provided value. Available: macOS 10.15+ windowtabbing-immutable: If true, disables “Prefer tabs when opening documents” checkbox. Available: macOS 10.12+

## Discussion

Discussion Specify com.apple.dock as the payload type. Profile availability  |   |   |   |   |   |   |   |  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

- [Dock.StaticItem](devicemanagement/dock/staticitem.md)

## See Also

### User experience

- [Accessibility](devicemanagement/accessibility.md)
- [Desktop](devicemanagement/desktop.md)
- [Finder](devicemanagement/finder.md)
- [HomeScreenLayout](devicemanagement/homescreenlayout.md)
- [ManagedMenuExtras](devicemanagement/managedmenuextras.md)
- [Notifications](devicemanagement/notifications.md)
- [ScreensaverUser](devicemanagement/screensaveruser.md)
- [SetupAssistant](devicemanagement/setupassistant.md)
- [TimeMachine](devicemanagement/timemachine.md)