Adding custom attributes to users and/or devices

You can add up to 300 custom attributes for users and 300 custom attributes for devices.

Procedure 

  1. Log into the Admin Portal.
  2. Go to Settings > System Settings > Users & Devices > Custom Attributes.
  3. In the Custom Device Attributes section, click Add+.
  4. Enter the information for the custom attribute for devices, including:

    Field

    Description

    Attribute Name

    Enter a name for the custom attribute.

    For Apple School Manager, use on the 1:1 (one-to-one) device use case and label it, for example, “ManagedAppleId”. This name can be whatever you choose, however, make note of it since you will select this custom attribute name when turning on Apple Education.

    Attribute Description

    Enter a meaningful description for the custom attribute.

    Value Type

    Select one of three value types: boolean, integer or string.

    For Apple School Manager, use the string value type.

    Variable Name

    This field is read-only and displays the machine-generated name of the device that is used as a substitution variable in policies and configurations. For example, the substitution variable $USERNAME$ is replaced with the actual device username.

    Actions

    Click Save. The new custom device attribute is created and displays in the table.

  5. (Optional) For Apple School Manager, click Add+and create a new Custom Device Attribute for device carts, for example, DeviceCartName, and choose the string value type. Remember this custom attribute name as you will need it when you turn on Apple Education in Core.

    When assigning values to these two custom attributes “ManagedAppleID” and “DeviceCartName”, do not assign the device to both values. A device can either be a 1:1 device or it can be a Shared iPad (multi-user). If a device is given both values, Core will display an error on the Apple Education policy or configuration. If a device is assigned to a device cart that is unknown or to a Managed Apple ID that is unknown, the device details Education Role will display as "None." If the device is given a known Managed Apple ID, but that ID is not assigned to any classes as either a teacher or a student, the device details will display the Apple Education Role as "None". If the device has a valid Managed Apple ID and that Apple ID is assigned to at least one class as a teacher, the Apple Education Role will be “Teacher”. If the device has a valid Managed Apple ID and that Apple ID is not assigned to a class as a teacher and is assigned to the class as a student, the Apple Education Role will be “Student”. If there is a value entered in the custom attribute for “DeviceCartName”, the Apple Education Role will be “Student (multi-user)”.

  6. In the Custom User Attributes section, click Add+.
  7. Referring to the table above, enter the information for the custom user attributes.
  8. Click Save. The new custom user attribute is created and displays in the table.
  9. (Optional) Repeat the steps, as needed.

Next steps 

Enabling Apple Education in Core