Creating User Groups and Users

Control interface access and data visibility using User Groups and Application Users.

Overview

Rayven uses a flexible user and group model to define which interfaces a person can access and what data they can see. Every Application User must belong to a User Group, and every User Group defines:

• Which interfaces are visible in the app

• What data the users in that group can access (via label filters)

• Whether all users in the group see the same data or their own filtered view (shared vs private)

This guide explains how to set up both User Groups and Users.

Creating a User Group

To create a new User Group, go to the Users section of your application in the Workspace and click Create User Group.

Required fields

• User Group Name – A descriptive name such as “Admin Team” or “Field Ops”.

• Filter User Group Data – Select one or more label values to filter what data the group can access.

  • Default is PrimaryLabel = All, giving access to all Primary Table rows.

  • You can use AND/OR logic to build more complex filters.

Optional settings

• Time Zone – Useful for applications involving time-based data. Affects how timestamps and date pickers behave.

• Group Type:

  • Shared Group – All users share the same data and layout.

  • Private Group – Each user in the group sees only data relevant to them. A label filter must be set for each user in this case.

• Select Interfaces – Choose which interfaces this User Group can access. These will be shown in the application’s left-hand navigation when users in this group log in.

Adding a New User

To add an Application User, go to the Users section in the Workspace and click Add User.

Fill in the following:

• First Name / Last Name

• Email – Used for login.

• Password – A temporary or predefined password. The user can reset this later.

• Permission Level:

  Role	Description
  Super Admin	Full access to all user groups, dashboards, settings, and management features. Super Admins can manage all user groups, export node data, and view Email & SMS logs.
  Admin	Can manage users within their own user group, edit Primary Tables configure reports, and edit content/layouts (if permissions are enabled). Cannot access other user groups or platform-level settings.
  Customer Admin	Similar to Admin but with slightly fewer rights. Can manage users within the group (view user list only) and configure reports. Cannot edit UIDs or interfaces.
  Editor	Can move and edit widgets (if enabled), export CSVs, and view historical chart data. Ideal for content contributors or operational staff needing moderate access.
  Basic Viewer	Read-only user with access to charts, historical data, and CSV export. Cannot modify layouts or widgets.
  Public Viewer	Minimal access role. Can view dashboards and shared content, but cannot interact with or export data. Useful for external stakeholders or public-facing roles.

   

• User Group – Choose from available groups.

Additional Permissions

• Edit Widgets – Allows the user to change widget settings directly within the App Interface.

• Edit Interfaces – Allows the user to drag, drop, resize, and reposition widgets on the App Interface.

About “Edit Widgets” Permission

In Rayven, Edit Widgets is an advanced permission that enables users to configure individual widgets directly from the App Interface.

When enabled:

• Users will see a three-dot menu appear in the top-right corner of each widget when they hover over it.

• Clicking this menu opens the Edit Widget panel, where users can:

  • Rename the widget

  • Adjust Y-axis/legend settings

  • Change formatting (decimals, colours, etc.)

  • Modify widget behaviour (e.g. refresh rate, data ranges, axis scaling)

  • Configure display-specific options like tooltips or visibility

This feature gives fine-grained control over how each widget behaves and looks but should be restricted to experienced users. It is not enabled by default, except for Super Admins, it must be explicitly granted when the user is created or updated.

Only users with both the correct permission level (Editor or higher) and the “Edit Widgets” checkbox enabled will see or be able to use the settings menu on widgets.

About “Edit Interfaces” Permission

The Edit Interfaces permission allows users to modify the layout of an interface by dragging, resizing, and repositioning widgets directly on the App Interface.

When enabled:

• Users can adjust widget sizing and position using a drag-and-drop interface.

• Changes apply to the entire User Group—any layout changes will be reflected for all users in the same group.

This permission is typically granted to users with Editor or Admin roles who are responsible for interface design or maintenance.
It does not allow users to change widget content or configuration—only the layout.

Adding a User to a Private User Group

If the user is being added to a Private User Group, you must also select a label value that filters data specifically for that user.

This enables each user in the group to see only their specific data (e.g., a single employee’s records or individual project assignments).

The label column used for filtering must already be configured in the Primary Table, and the value selected here must match one of the allowed values in that column.

Summary

User Groups and Users in Rayven provide a secure and configurable way to manage who sees what within your application. Grouping users by role, team, or location lets you tailor the experience and ensure access to only the relevant data and functionality.

FAQs

Can I assign a user to multiple User Groups?
Yes. Application Users can belong to multiple User Groups within a single application. When logged in, they will see a dropdown in the App Interface that allows them to switch between their assigned User Groups. The interfaces and data they see will update based on the configuration of the selected group.

How do I show different interfaces to different users?
Create separate User Groups, assign different interfaces to each, and assign users accordingly.

What is the difference between a Shared and a Private User Group?

• Shared Group: All users see the same data and interface layout.

• Private Group: Users share the layout, but each sees only their own data (based on a label filter set per user).

How is data filtered for users in a Private Group?
Each user is assigned a specific label value when created. This filters the data visible to them across the application.

Can users edit their own interfaces?
Only if their permission level is Editor or higher and the “Edit Interface” permission is enabled. However, interface layouts are shared across the User Group—so any changes a user makes will affect all users in that group.

What happens if no label filter is set?
The default is PrimaryLabel = All, so users will see all rows in the Primary Table unless explicitly filtered.