Learn which variables are available and where to utilize them inside Kandji
Kandji's Global Variables feature allows you to automatically input unique device details into any profile text field within any Configuration Profile (Custom Profiles or Library Items) or App Config.
Available 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. |
If at anytime 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 page.
How to use Global Variables
Global Variables can be used inside of any text field within any Configuration Profile (Custom Profiles or Library Items); as well as the Full Name and Short Name fields for the Provision Local Administrator Account section 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.
In this example, we used the Conference Room Display Mode library item. Simply enter the desired variable you wish to use in the text field of the profile and save. When deployed, the Apple TV will display its Asset Tag as defined in Kandji.