Working with device groups in the nRF Cloud portal

This page explains how to work with device groups in the nRF Cloud portal. See an introduction to device groups or more on using device groups with the APIs.

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.

To edit a user's assigned groups:

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 Save.

Adding individual devices to groups

To add individual devices to a new or existing group:

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.

   The Actions menu appears above the card.

4. Click Actions to open a drop-down menu.

5. Click Add to group.

   The Manage device groups pop-up opens.

6. Enter a group name or select an existing group. A single device can be in multiple groups.

7. Click Save.

Viewing devices by group

To view devices by group:

1. Select Device Management from the left sidebar.

2. Select Devices.

3. Below the page title, find the Group by filter.

4. Click the arrow next to the filter.

   A drop-down menu opens.

5. Select Device group.

Your devices are now organized by device group, with one card for each group. Sort devices within a group using the Sort by drop-down menu.

The first card shows devices that are not associated with any group.

Filtering devices by type

To filter devices by type:

1. Select Device Management from the left sidebar.
2. Select Devices.
3. Below the page title, find the Show selector.
4. Click Bluetooth, LTE, or Gateway to show only devices of each type. The default is All.

Using device groups for FOTA

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

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.