Device Groups
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
| Action | Required Role |
|---|---|
| View groups and members | Viewer, Installer, Designer, Manager |
| Create, edit, delete groups | Installer, Designer, Manager |
| Configure group devices | Installer, 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
- Tap the + (Add) button
- Enter a name for the group (minimum 4 characters, must be unique)
- Tap Add
The new group appears in the list, ready for you to add devices.
Use clear, descriptive names that indicate the group’s purpose — e.g., “Floor 2 Temperature Sensors” or “Phase 1 Deployment”.
Adding Devices to a Group
Open the group and tap Add to add devices. You can add devices in two ways:
Via QR Code
- Tap Scan QR code
- Point the camera at the device QR code
- The device is added to the group
- Repeat for additional devices
Via Search
- Tap Search
- Enter a device name or ID
- Select the device from the results
- The device is added to the group
- Repeat for additional devices
A device can belong to multiple groups.
Removing Devices from a Group
- Swipe left on the device in the group member list
- Tap Remove
- Confirm removal
Removing a device from a group does not delete the device — it only removes the group association.
Deleting a Group
- Swipe left on the group in the group list
- Tap Delete
- 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:
- Open the group
- Tap Configure in the toolbar
- Set the desired configuration parameters
- 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
| Purpose | Example Groups |
|---|---|
| Functional | HVAC Sensors, Security System, Gateways |
| Location-based | Building A Devices, 3rd Floor, Outdoor Sensors |
| Project | Phase 1 Deployment, Pilot Program, Q1 Installation |
| Maintenance | Battery 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
- Keywords — Organize devices with keyword tags
- Configuration — Configure individual devices
- Device Alerts — Monitor device health across your fleet