Managing Groups

What are Groups?

Groups within the Mason Platform are a collection of devices that can have software or software configurations deployed to them.

You can use groups to either maintain your software releases based on locality, and/or maintain your software promotion across phases such as “development”, “staging”, or “production”.


  • A single device can only belong to a single group.
  • You cannot have groups of groups.
  • Only one model of device is supported per group.

Creating a Group

To create a Group, you need to have a valid Mason Platform account configured. Please contact Mason Support to ensure that you have a Mason account configured already.

From the Mason Platform Devices Dashboard, you can click “Add Group” to create a new Group.

Add Group Image

On the Mason Group creation dialog, choose a name which fittingly represents the goals of the group. Please note that the name of the group will be the name that is utilized when interfacing with the Mason CLI.

You may choose to add a description to further detail the purpose of the group for your own bookkeeping.

New Project Image

Once the fields are populated, click “Create” to create the group and finish the flow.

Assigning Devices to Groups

Devices which have finished provisioning, but have not yet been assigned to a group sit in an Unassigned state and cannot be deployed to.

To assign a group to a device or devices, check each device then click move in the toolbar.

Move Device Image

Once a device is assigned to a group, you may deploy software or software configurations to it.

  • For more details on creating a Mason Project Configuration, see Defining a Project Config
  • For information on deploying software or software configurations to a group, see Mason CLI