Global Variables

By Jeff Saul

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 or one from the library) or App Config

Available Variables

Below is a full list of Global Variables that can be used inside of profiles and App Config. 

VariableDescription
$SERIAL_NUMBERInserts the Serial Number of the device the profile installs to.
$DEVICE_NAMEInserts the Device Name of the device the profile installs to.
$ASSET_TAGInserts the Asset Tag of the device the profile installs to.
$UDIDInserts the Unique Device Identifier of the device the profile installs to.
$PROFILE_UUIDInserts the Universally Unique Identifier of the profile.
$EMAILInserts the Email Address of the Assigned User for the device. 
$FULL_NAMEInserts the Full Name of the Assigned User for the device. 
$EMAIL_PREFIXInserts the Email Prefix of the Assigned User for the device. (Everything before the @ symbol) 

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 a Kandji Profile, any custom profile; 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 Profile. Simply enter the desired variable you wish to use in the text field of the profile you are modifying and save. When deployed, the Apple TV will display its Asset Tag as defined in Kandji.