Groups are the core organizational structure used within the VeeaONE platform. They define how users, devices (VeeaHubs), and Meshes are organized, managed, and accessed across the system. Every account operates within the context of one or more groups, allowing collaboration and delegation of responsibilities across teams or deployments.
Hierarchy and Visibility
Groups are hierarchical and can contain nested subgroups, forming a tree-like structure. For example, a group structure could look like this:
A
└── B
└── C
└── D
If you are a member of group B, you will automatically have visibility and access to its subgroups C and D. However, you will not have visibility into any parent groups such as A. This ensures that group access is scoped downward only, protecting the integrity and privacy of higher-level groups.
Ownership and Membership
Every group has an assigned owner — the person responsible for managing its settings and members. Group owners have full administrative privileges within their group and its subgroups, including:
- Inviting new members
- Managing VeeaHubs and Meshes
- Creating or removing subgroups
- Assigning or revoking roles
As a user, you can be invited to join any group. Once part of a group, you can interact with all assigned resources (e.g., devices, networks, notifications) according to the permissions granted. You may also leave a group at any time, unless you're the sole owner — in which case, ownership must be transferred before departure.
Automatic Group Creation
When you create a new account on the platform, a default group is automatically created for you. This becomes your personal workspace and includes you as the group owner. From there, you can invite others, build subgroups, and assign VeeaHubs or Meshes to any part of the hierarchy you create.
Use Cases for Groups
- Multi-site deployment: Use subgroups to represent physical locations like branches, offices, or buildings.
- Team-based management: Separate groups for different departments or user roles, each with their own VeeaHub access.
- Scalable access control: Grant access only to the required group levels, limiting visibility to child nodes.
By using groups effectively, you gain full control over how resources are structured, who can see or manage them, and how responsibilities are delegated across users and teams.
Group management is carried out from the Settings GROUPS tab, where you can search for a group name in the list of groups which you are a member. You also have the option to leave a selected group.
An example group listing is shown above. Actions provided are:
- Add group to Favorites list
- Quick-switch to the group
- Leave group
Invite a Group User with Permissions
Managers can invite a group user and add permissions. Select a group user to begin adding or removing permissions (Fig 49a).
- From the 'Members' screen, select the 'Invite Users' button.
- An 'Invite Member' window opens. In the 'Search' field, enter the email address of the user.
- Select the 'Search' button. If the user is in the system, the user name appears under the search box.
- Select 'Allow this user to receive group notifications' to allow the user to receive notifications. Select 'Allow this member to manage devices' to allow the user to manager devices.
- Select the 'Invite' button to invite the user.
- Select the 'Close' button to close the window.
Edit a Group User's Permissions
Managers can edit a group user's permissions. Select a group user to begin adding or removing permissions (Fig 49b).
- From the 'Members' screen, select a group user to begin adding or removing permission.
- A 'Permissions' window opens. Select 'Allow this user to receive group notifications' to allow the user to receive notifications. Select 'Allow this member to manage devices' to allow the user to manager devices.
- To remove permissions, deselect the checkbox.
- Select the 'Save Changes' button to save the changes.
- Select the 'Close' button to close the window.
Create a Subgroup
Managers can create subgroups within a group. Select a group to add a subgroup. A maximum of five levels are allowed in the groups hierarchy.
- From the 'Group Info' screen, click the 'Create Subgroup' button (Fig 49d).
- A 'Create Subgroup' window opens. In the 'Name' enter the name of the subgroup (Fig 49e).
- Click the Red 'Create' button to create the group.
Move Groups
Groups can be moved to another group hierarchy if they are managed by the same administrator. Groups with meshes enrolled in them can also be moved.
- From the 'Group Info' screen, click the 'Move Group' button (Fig 49f).
- The groups window opens. Select the group to move.
- Click the 'Move Group' button to move the group (Fig 49g).