For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  1. In the left navbar when viewing any app

  2. 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.

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.

Last updated