# Device groups

A device group is a set of devices that is used for organizational purposes. \
The standard user will be able to access a limited number of groups, this way the admin can limit the visibility of each group by user.

### Add a device group

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mgf4wby1nhNas9J0n_V%2F-MkqfMxBazqhdFgLmtZv%2F-MkqhmKmxgr109sK1U_I%2Fimage.png?alt=media\&token=76dacbce-9d1a-4352-bb15-b7dcd78bb6dc)

1. Use **+ Add group** button (ref. 1 here above) to create a new group in the relative hierarchy level (column A here above) 
2. Use the "**plus**" button (ref. 2 here above) to create a new level

### Add a group category

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mgf4wby1nhNas9J0n_V%2F-MkqfMxBazqhdFgLmtZv%2F-MkqhY8RHcg9kd0gRJ6f%2Fimage.png?alt=media\&token=94891f88-ec9f-4bf3-9beb-d2f2b23194e5)

Categories are required to be able to create sub-groups.\
For example, here above, is a three level structure Visup, Dealer and Customer *(A, B, C)*

### Group managing

To create sub-groups, you need to have at least a lower level category first. \
For example, this is a two level structure Visup and Dealer

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mgf4wby1nhNas9J0n_V%2F-MkqfMxBazqhdFgLmtZv%2F-Mkr9SFBDyUw0gLmutj4%2Fimage.png?alt=media\&token=4dfca988-e908-48a9-9687-521550d74f21)

When you click on the box you want to manage, a **list of users** with permissions related to that group (ref. 2 here above) is shown on right side. At the same time a **+ Add group** button appears into the next available level (ref. 1 here above) to add sub-groups in it.

{% hint style="info" %}
Categories are a way to assign user permissions to top-level groups which will propagate to all their sub-groups
{% endhint %}

#### Assign a device to a group

You can change a machine group in the "Change Group" popup, accessed from the action menu in the [device list](https://admin-things5.gitbook.io/things5/device/manage-devices/device-list) item (ref. 1 here below), the available groups (ref. 2 here below) can be seen in the list.

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mgf4wby1nhNas9J0n_V%2F-MkqfMxBazqhdFgLmtZv%2F-MkrCyAlLR5im9le9-We%2Fimage.png?alt=media\&token=24551057-2a7e-4432-8571-09e5ff1138e4)

### Edit or delete a device group

<div align="left"><img src="https://887564422-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mgf4wby1nhNas9J0n_V%2F-Mkgjvm606gDoWxP2eDB%2F-MkgxqRcOBbiZWKJQPHH%2Fimage.png?alt=media&#x26;token=b1169fd6-c3ff-4201-bdf0-c0832f0ccf10" alt=""></div>