> For the complete documentation index, see [llms.txt](https://kb.motion.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.motion.cloud/motion-platform-software/sharing.md).

# Sharing

Hubs, devices, tiles, and apps can be shared between users.&#x20;

To share any of these objects with another user, you must be either the **Owner** of the object or you must have been assigned the **Admin** *role* for the object.

For most scenarios, users will want to share apps with one another because apps are built to have the precise set of tiles needed for a given use case.

## How to Share

Sharing is possible anywhere the <img src="https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FOwBvUYcHwc1msG8JdXxL%2Fimage.png?alt=media&amp;token=a35679d0-b7c3-409f-9ed8-98e82841034e" alt="" data-size="line"> button is found.&#x20;

Here are the places you can find the <img src="https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FDlcyfoX1DFw09SiOgjd6%2Fshare.png?alt=media&amp;token=36736047-114e-4719-89c9-ef9121d64145" alt="" data-size="line"> button for each object type:

| Object Type | Share Button Location\[s]                                                                                                                                                                                       | What is Shared                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| App         | <ol><li>In the left navbar when viewing any app</li><li>In the <a href="https://platform.motion.cloud/apps/manage/existing">Apps → Manage</a> view, accessible from the Apps view via the left navbar</li></ol> | The app and all tiles within it                                                                        |
| Device      | In the [Controls → Devices](https://platform.motion.cloud/controls/devices) view, under each device name                                                                                                        | The device and all tiles associated with the device                                                    |
| Hub         | In the [Controls → Hubs](https://platform.motion.cloud/controls/hubs) view, under each hub name                                                                                                                 | The hub and all devices associated with the device, as well as all tiles associated with those devices |
| Tile        | In the [Controls → Tiles](https://platform.motion.cloud/controls/tiles) view, under each tile name                                                                                                              | The tile only                                                                                          |

After clicking any <img src="https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FRqBaVHdto6V30MYGfitI%2Fshare.png?alt=media&amp;token=2babdc22-84d2-407a-9552-5b7ed289f3ef" alt="" data-size="line"> button, click **Add User** on the top right of the sharing panel. Here, you can enter either:

1. The user's Motion username
2. The user's email address that is associated with Motion

<figure><img src="https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2FS1p3jAKcTomoqBrTkTe6%2Fplatform.motion.cloud_mosaic_70005_dashboard.png?alt=media&amp;token=574d4c3e-fbd0-44e0-9a70-6ee009db620a" alt="" width="563"><figcaption></figcaption></figure>

After a matching user is identified, choose the roles the user should have:

<figure><img src="https://3085605247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIDUOppGMO2NaZpQxdch%2Fuploads%2F3Sj2gc1tRmVcA0fCas5L%2Fplatform.motion.cloud_mosaic_70005_dashboard%20(1).png?alt=media&amp;token=db779d5a-2c8a-4b97-90d6-f3ce59eaa42b" alt="" width="563"><figcaption></figcaption></figure>

For more information on what permissions are given with different roles, see [Roles and Permissions](https://api-docs.motion.cloud/technical-notes/roles-and-permissions) in our API docs.

{% hint style="warning" %}
Assigning the **Admin** role will give the user the ability to share and un-share the object with other users.
{% endhint %}

{% hint style="info" %}
Multiple roles can be assigned to a single user simultaneously, and different roles may come with overlapping permissions.

Therefore, e.g., it is not necessary to assign any additional roles to a user if they have the **Admin** role because the **Admin** role gives that user all permissions.
{% endhint %}
