What are Global Variables?
Global variables (or environment variables) are dynamic values that influence how processes and applications behave. These variables store essential information like system paths, user details, and configuration settings, which can be accessed and utilized by various programs and scripts. Kandji's global variables feature allows you to automatically input unique device details into most profile text fields within profiles—including Custom Profiles and other Library Items—or App Config.
How to use Global Variables in Kandji
Global variables can be used inside most text fields within Profiles (Custom Profiles or Library Items) and the Provision Local Administrator Account section's Full Name and Short Name fields in the Automated Device Enrollment Library item. Global variables work for all device types. Variables can also be used multiple times in the same field.
If a device variable that is used on a profile is updated, that profile will be re-installed on the device with the updated variable. For use in custom scripts, we have examples of a Custom Profile that populates those values locally, and a Custom Script which reads those values back into the web app on our GitHub repo. Ensure that you do not use the Zsh shell when referencing these variables in scripts as some variables will not render correctly.
Available Global Variables
All Device Families | |
Variable | Description |
| Inserts the Serial Number of the device the profile installs on. |
| Inserts the Device Name of the device the profile installs on. |
| Inserts the Asset Tag of the device the profile installs on. |
| Inserts the Device ID of the device the profile installs on. |
| Inserts the Unique Device Identifier of the device the profile installs on. |
| Inserts the Universally Unique Identifier of the profile. |
| Inserts the Email Address of the Assigned User for the device. |
| Inserts the Full Name of the Assigned User for the device. |
| Inserts the Email Prefix of the Assigned User for the device. (Everything before the @ symbol) |
| Inserts the Username of the Assigned User in Kandji. |
| Inserts the Username Prefix of the Assigned User in Kandji. (Everything before the @ symbol) |
| Inserts the Department of the Assigned User for the device. |
| Inserts the Job Title of the user that is defined in the identity provider. |
| Inserts the Blueprint ID of the Blueprint the device is assigned to. |
| Inserts the Blueprint Name of the Blueprint the device is assigned to. |
| Inserts the Model Name of the device the profile installs on. |
| Inserts the Model Identifier of the device the profile installs on. |
iPhone and Cellular iPad Only | |
Variable | Description |
| Inserts the MEID of the device the profile installs on. |
| Inserts the ICCID for SIM slot 1 of the device the profile installs on. |
| Inserts the ICCID for SIM slot 2 of the device the profile installs on. |
| Inserts the IMEI for SIM slot 1 of the device the profile installs on. |
| Inserts the IMEI for SIM slot 2 of the device the profile installs on. |
| Inserts the Phone Number for SIM slot 1 of the profile. |
| Inserts the Phone Number for SIM slot 2 of the Assigned User for the device. |
iPhone, iPad, and Apple TV Only | |
Variable | Description |
| Inserts the Model Number of the device the profile installs on. |