Skip to content

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

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.

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.

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.

  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.