# Device sharing

The **sharing procedure** is to share one or more devices between different organizations.\
To achieve that, you won't share a specific device but a [group of devices](https://admin-things5.gitbook.io/things5/device/manage-devices/device-groups) instead.

{% hint style="info" %}
**Device Sharing** is one-to-one link and its not possible to share any **device group** with more than one organization.
{% endhint %}

### The involved entities

For this example we'll call the organization who really own the devices, the <mark style="color:purple;">**share\_holder**</mark> \
and the organization that the devices will be shared to, that we call the <mark style="color:red;">**share\_receiver**</mark>&#x20;

<mark style="color:red;">**share\_receiver**</mark> asks <mark style="color:purple;">**share\_holder**</mark> to let him to see and manage one or more of their devices.

To do so, the <mark style="color:red;">**share\_receiver**</mark> will send its personal sharing code to the <mark style="color:purple;">**share\_holder**</mark> in order to start the procedure

### Get the sharing code

To get this sharing code, <mark style="color:red;">**share\_receiver**</mark> must access the **Groups** menu, under **Devices** section (<mark style="color:purple;">**ref. 1**</mark>), and click the **Shared with you** button (<mark style="color:purple;">**ref. 2**</mark>) to open a modal window where this code is shown (<mark style="color:green;">**ref. A**</mark>). He have to manually copy it or simply click on **Copy** (<mark style="color:purple;">**ref. 3**</mark>) send the code to the <mark style="color:purple;">**share\_holder**</mark>.

Inside this modal is also possible to regenerate a brand-new code in order to invalidate the old one, by clicking on the **Refresh** button (<mark style="color:purple;">**ref. 4**</mark>)

In the same modal is possible see which organizations, if any, are sharing devices with you (<mark style="color:green;">**ref. B**</mark>)

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgf4wby1nhNas9J0n_V%2Fuploads%2FAqnAArZVv6wggOKoKYwk%2Fimage.png?alt=media\&token=063fc93f-7dc5-4c44-8e56-1459e007f6df)

### Do the sharing

Once the <mark style="color:purple;">**share\_holder**</mark> receive that sharing code, he must access the **Groups** menu, located under **Devices** section (ref. 1), open the service menu relative to machine group he want to share (ref. 2), and click the **Share group** function (ref. 3)

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgf4wby1nhNas9J0n_V%2Fuploads%2F5cBBADU0l09zZn8MzFga%2Fimage.png?alt=media\&token=c91b8eac-aa90-4589-9819-7ed3b15a520e)

In this popup enter the sharing code (ref. 1) and select the role (ref. 2) that the other organization will have. (more about [Roles](https://admin-things5.gitbook.io/things5/users/manage-roles))

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgf4wby1nhNas9J0n_V%2Fuploads%2Fp3QhmRqDKZJvIRAuITfj%2Fimage.png?alt=media\&token=bdc8701c-275d-42a4-bfa8-a6e18df41935)

### Icon for shared groups&#x20;

The groups that are shared with an organisation are marked with a specific icon that shows the name of that organization in both the Group list and the Device list

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgf4wby1nhNas9J0n_V%2Fuploads%2FPljCslr6M7enZai5Ucbw%2Fimage.png?alt=media\&token=76a5f953-120d-41a3-9514-3d54c559f91b)

![](https://887564422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgf4wby1nhNas9J0n_V%2Fuploads%2FbnJAQ0QfaM3am3KumWPL%2Fimage.png?alt=media\&token=638e63ff-45b3-4383-b1b8-6640d552cc37)