Device Groups

Create logical groups of devices for combined monitoring and configuration

Overview

Device groups let you organize devices into logical collections for bulk monitoring and configuration. Unlike keywords (which categorize devices by metadata), groups are explicit lists of devices you assemble for a specific purpose — such as a maintenance batch, a deployment phase, or a set of devices that share the same configuration.

Requirements

ActionRequired Role
View groups and membersViewer, Installer, Designer, Manager
Create, edit, delete groupsInstaller, Designer, Manager
Configure group devicesInstaller, Designer, Manager

Accessing Device Groups

From the main navigation, tap Device groups under the Devices section. You see a list of all groups with device counts.

Viewing Groups

  • Scroll the list to see all groups
  • Use the search bar to filter groups by name
  • Tap a group to view its members

Each group shows the number of devices it contains.

Creating a New Group

  1. Tap the + (Add) button
  2. Enter a name for the group (minimum 4 characters, must be unique)
  3. Tap Add

The new group appears in the list, ready for you to add devices.

Adding Devices to a Group

Open the group and tap Add to add devices. You can add devices in two ways:

Via QR Code

  1. Tap Scan QR code
  2. Point the camera at the device QR code
  3. The device is added to the group
  4. Repeat for additional devices
  1. Tap Search
  2. Enter a device name or ID
  3. Select the device from the results
  4. The device is added to the group
  5. Repeat for additional devices

A device can belong to multiple groups.

Removing Devices from a Group

  1. Swipe left on the device in the group member list
  2. Tap Remove
  3. Confirm removal

Deleting a Group

  1. Swipe left on the group in the group list
  2. Tap Delete
  3. Confirm deletion

Deleting a group does not affect the devices that were in it.

Group Configuration

Installers, Designers, and Managers can apply configuration changes to all devices in a group at once:

  1. Open the group
  2. Tap Configure in the toolbar
  3. Set the desired configuration parameters
  4. Apply the configuration to all group members

This is useful when you need consistent settings across a set of devices — for example, setting the same reporting interval on all sensors in a building.

Use Cases

PurposeExample Groups
FunctionalHVAC Sensors, Security System, Gateways
Location-basedBuilding A Devices, 3rd Floor, Outdoor Sensors
ProjectPhase 1 Deployment, Pilot Program, Q1 Installation
MaintenanceBattery Replacement, Firmware Update, High-Priority

Best Practices

  • Name clearly: Include the purpose or criteria in the group name
  • Keep it manageable: Very large groups (100+ devices) may be slower to load — consider splitting by sub-criteria
  • Review periodically: Remove groups that are no longer needed
  • Combine with keywords: Use keywords for permanent categorization, groups for temporary or task-based collections

Next Steps