Learn which variables are available and where to use them
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 any profile text field within any profile—including Custom Profiles and other Library Items—or App Config.
How to use Global Variables in Kandji
Global Variables can be used inside any text field within any Profile (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.
Available Global Variables
Below is a full list of Global Variables that can be used inside configuration profiles and App Config.
| Variable | Description |
| $SERIAL_NUMBER | Inserts the Serial Number of the device the profile installs to. |
| $DEVICE_NAME | Inserts the Device Name of the device the profile installs to. |
| $ASSET_TAG | Inserts the Asset Tag of the device the profile installs to. |
| $DEVICE_ID | Inserts the Device ID of the device the profile installs to. |
| $UDID | Inserts the Unique Device Identifier of the device the profile installs to. |
| $PROFILE_UUID | Inserts the Universally Unique Identifier of the profile. |
| Inserts the Email Address of the Assigned User for the device. | |
| $FULL_NAME | Inserts the Full Name of the Assigned User for the device. |
| $EMAIL_PREFIX | Inserts the Email Prefix of the Assigned User for the device. (Everything before the @ symbol) |
| $DEPARTMENT | Inserts the Department of the Assigned User for the device. |
| $JOB_TITLE | Inserts the Job Title of the user that is defined in the identity provider. |
| $BLUEPRINT_ID | Inserts the Blueprint ID of the Blueprint the device is assigned to. |
| $BLUEPRINT_NAME | Inserts the Blueprint Name of the Blueprint the device is assigned to. |