Sharing

Hubs, devices, tiles, and apps can be shared between users.

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 button is found.

Here are the places you can find the button for each object type:

Object Type	Share Button Location[s]	What is Shared
App	In the left navbar when viewing any app In the Apps → Manage view, accessible from the Apps view via the left navbar	The app and all tiles within it
Device	In the Controls → Devices view, under each device name	The device and all tiles associated with the device
Hub	In the 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 view, under each tile name	The tile only

After clicking any 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

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

For more information on what permissions are given with different roles, see Roles and Permissions in our API docs.

Assigning the Admin role will give the user the ability to share and un-share the object with other users.

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.