> 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="/files/nuO8lGCCFze02xIy4sWc" alt="" data-size="line"> button is found.&#x20;

Here are the places you can find the <img src="/files/JC93UnaUUoWpCcL8Dk3Y" 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="/files/jRD6bGtjNUK4tVgZmffG" 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="/files/PaWfDWaJMIL1lOfFZlCu" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/kuMHv9qoBpo05Uvb4T0O" 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 %}
