Using the Jamf Helper to Display Messages to Users

Jamf Pro Documentation 11.16.0
Solution
Application
Content Type
Technical Documentation
Utilities & Services
version
11.16.0
ft:locale
en-US
vrm_version
11.16.0

The Jamf Helper is a utility automatically installed by Jamf Pro on all managed computers. It allows you to display customizable, interactive messages to end users during policy executions, software installations, or any automated workflow in Jamf Pro. You can use it to show informational messages, warnings, or request user input.

Requirements

Privileges to create and edit scripts in Jamf Pro

Note:

While you can display basic messages to users using the examples below, more advanced uses (like collecting user input or creating interactive workflows) require knowledge of bash scripting. If you're not comfortable with scripting, start with the basic examples and consult with your IT administrator for more complex implementations.

  1. In Jamf Pro, click Settings in the sidebar.
  2. In the Computer management section, click Scripts .
  3. Click New.
  4. Enter a display name for your script.
  5. In the Script tab, add your Jamf Helper command as a bash script.
    Note:

    This example displays a utility window with a software update message and an OK button for the user to acknowledge:

    #!/bin/bash

"/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper" \
-windowType "utility" \
-title "Software Update" \
-description "Updates are being installed on your computer. Please do not shut down or restart." \
-icon "/System/Library/CoreServices/Software Update.app/Contents/Resources/SoftwareUpdate.icns" \
-button1 "OK"
  6. Click Save .
  7. Add the script to a policy to display the message during policy execution.

The Jamf Helper messaging triggers on end user computers according to the settings of the policy it is included in.