Skip to content

Device Groups

Device groups let you organize devices into logical collections for bulk management and Blueprint assignment.

Creating a Group

Navigate to Devices > Groups and click Create Group. Fill in the following fields:

FieldRequiredDescription
NameYesA descriptive name for the group (e.g., "Sales Team iPads")
DescriptionNoOptional notes about the group's purpose
ColorYesA color label for visual identification in the dashboard

Available Colors

Choose from four color options:

  • Blue — default, general-purpose groups
  • Purple — management or admin groups
  • Green — operational or production groups
  • Orange — special or temporary groups

The color is displayed as a badge next to the group name throughout the dashboard.

Adding Devices

Two-Panel Picker

After creating a group, add devices using the two-panel picker:

  1. The left panel lists all available devices (searchable and paginated)
  2. Select devices by checking the boxes next to them
  3. Click Add to move them into the group
  4. The right panel shows the current group members

The search bar in the left panel supports partial matching against device name and serial number, making it easy to find specific devices even in large fleets.

Bulk Import by Serial Number

For adding many devices at once:

  1. Click Import by Serial Number in the add-device dialog
  2. Paste a list of serial numbers (one per line, or comma-separated)
  3. The system validates each serial and highlights any that are not found
  4. Click Add All to add all valid matches to the group

This is the fastest way to populate a group when you have a list of serials from procurement or inventory records.

Viewing Group Members

Click on any group in the group list to open its detail view. The member list shows each device's name, serial number, OS, status, and last-seen timestamp. You can remove individual devices from this view using the action menu on each row.

Editing and Deleting Groups

  • Edit — change the group name, description, or color at any time. Existing group membership is preserved.
  • Delete — removes the group. Devices in the group are not affected — they remain enrolled and managed individually. Only the group itself is deleted.

Groups and Blueprint Assignment

Groups are the primary mechanism for Blueprint assignment. When you create or edit a Blueprint, you select one or more groups to apply it to. All devices in those groups receive the Blueprint's configuration profiles, restrictions, and apps automatically.

This means you manage policy by group membership — adding a device to a group applies the associated Blueprint, and removing a device from a group removes it from that Blueprint's scope.

Released under the MIT License