Organizing devices in the nRF Cloud portal

This page explains how to organize devices and work with device groups and tags in the nRF Cloud portal. See an overview of concepts related to device groups, or more on organizing devices with the APIs.

Managing device groups

Each tab in this section explains a different operation related to tag and group management.

Adding individual devices to groupsRemoving devices from a groupDeleting a group

You can add up to 100 devices to a group at a time by adding a tag to the selected devices.

To add new or existing tags to devices:

1. Select Device Management in the left sidebar.

2. Select Devices.

   The device page opens.

3. Select the checkbox next to each device you want to add.

4. Click the Add to group button.

   The Manage device groups pop-up opens.

5. Enter a new tag and press the Enter key, or select an existing tag to add. A single device can have multiple tags, and you can add more than one tag to selected devices at a time.

6. Click the Save button.

1. Select Device Management in the left sidebar.

2. Select Groups.

   The Groups page opens.

3. Click the name of the group you want to modify.

4. Select the checkbox next to any devices you want to remove from the group.

5. Click the Remove button.

   A pop-up opens.

6. Click OK to confirm.

To delete a group, remove its tag from all associated devices. If a group contains no devices, it is automatically deleted.

1. Select Device Management in the left sidebar.
2. Select Groups.
3. Click the name of the group you want to delete.
4. Select the checkbox in the table header, next to Type. This selects all devices in the group.

5. Click the Remove button.

   A pop-up opens.

6. Click OK to confirm.

   If the group still appears on the Groups page, refresh the page. The group is now deleted.

Controlling device access with groups

When you, as an admin or owner, invite a new user to a team, you can choose which groups that user has access to. See more about device restriction by group.

Access

Only admin and owner users can invite users, change another user's role, or change a user's access to groups. Admins and owners always have access to every device group.

Once a viewer or editor has accepted your invitation and joined your team, you can edit which device groups they have access to.

Editing a user's assigned groups

To specify or change the groups a user has access to:

1. Log in to the nRF Cloud portal.
2. Click the three-line menu in the upper right corner.

3. Select Team.

   The Current Team page opens.

4. Find the Team Members card.

5. Click the gear icon next to the team member's information.

6. Select Edit device groups.

   The Manage User's Device Groups pop-up opens.

7. Edit groups assigned to the user. You can type in the group name or click the arrow to open a drop-down menu:

   • To revoke access to a group, click the X next to the group name. To remove access to all groups, click the X in the text box next to the drop-down arrow. This clears all groups.
   • To give access to a group, select the group you want to add.

8. Click the Save button.

Filtering devices

This section explains the different ways to filter devices. Applying one filter also affects other filters: for example, if you apply a Type filter for LTE devices, the Name filter will only contain names of LTE devices.

By type, name, or IDBy group

To view devices by type, name, or ID:

1. Select Device Management from the left sidebar.
2. Select Devices.
3. Click Filter above the device table.
4. Click the arrow next to the desired filter and select device type, name or ID. Available choices depend on which types of devices you have added to your team.
5. Apply more filters as needed.

The table shows only devices matching the selected filters.

To view devices by group:

1. Select Device Management from the left sidebar.
2. Select Devices.
3. Click Filter above the device table.
4. In the Groups filter, click the arrow next to the filter and select the desired device group.

The table shows only devices belonging to the selected group, according to the user's role and permissions.

Viewing alerts

To view alerts for devices in a group:

1. From the Groups page, click the name of the desired group.

   The group's page opens.

2. Find the Alerts card.

From this card, you can view and archive alerts.

Viewing device location

To view the latest location data from devices in a group:

1. From the Groups page, click the name of the desired group.

   The group's page opens.

2. Find the Group locations card.

If the devices in the group are compatible with Location Services and have reported location data, you can view their last known locations. The table below the map shows the device's number on the map, ID, latitude, and longitude, and distance in kilometers from a given reference point.

To set a reference point, right click on the map and select Yes when prompted. The Distance column of the table updates to show each device's distance from the reference point.

To view historical location data for a single device, click the device ID.

Using device groups for FOTA

Once you add devices to a new or existing group, you can use them to specify FOTA targets:

From the Firmware Update pageFrom the Groups page

1. Create a new group or add devices to an existing group.
2. Select Device Management from the left sidebar.

3. Select Firmware Updates.

   You can view existing groups and their devices under the Groups card.

4. Continue with creating a FOTA update job.

1. Select Device Management from the left sidebar.
2. Select Groups.
3. Click the name of an existing group to open its page.
4. Select the checkbox next to the devices you want to target.
5. Click the Create Update button.
6. Continue with creating a FOTA update job.