Modifying the macOS Dock

By Vicky Munsell

Learn how to create a custom profile to configure the macOS Dock

After deploying applications to your macOS devices, adding their icons to the dock can make them easier for your users to find. Adding icons to the dock can be accomplished by creating a custom profile.

This method will lock the dock so that the end user cannot change it. If you would like a scriptable option to allow users to change their dock, please see our article on the Kandji Agent Command Line Interface.

Download and Install iMazing Profile Editor

  1. Download iMazing Profile Editor from their website, or the Mac App Store.
  2. If downloaded directly, open the iMazingProfileEditorMac.dmg and drag iMazing Profile to your Applications folder.

Create your Dock Profile

Once you have iMazing Profile Editor open, follow these steps.

  1. Select the General domain on the left side.
  2. Set Name to whatever you would like the profile name to be.
  3. Set Identifier to a unique string.
  4. Set Organization to your Organization's name.
  5. Set Payload Description to describe the profile's purpose.

  6. Set Payload Scope to System.
  7. In the upper right-hand search box, search for Dock, and Add Configuration Payload.
  8. Configure the appropriate options inside of the Dock payload.

9. Navigate to the Menu Bar and click File > Save.

10. Select a save location and Save your profile.

If deploying via Kandji, there is no need to sign the profile. Kandji will sign it when it is deployed.

Add your Custom Profile Library Item

  1. Click Library from the left-hand navigation bar.
  2. Click Add New on the top right-hand side.
  3. Click Custom Profile.
  4. Click Add & Configure.

Upload your Custom Dock Profile to Kandji

  1. Give your profile a Name.
  2. Select a Blueprint from the Blueprint Assignment dropdown.
  3. Set your Device family to Mac.
  4. Drag and drop your dock profile to upload it.
  5. Save your custom profile.

The devices enrolled in the selected Blueprints will display the customized Dock after their next check in with Kandji.