Using Labels to Filter Data by User Groups

Control which data each user group can access by applying label-based filters in Rayven.

Overview

In Rayven, labels are a powerful way to group and filter data stored in your Primary Tables. When combined with user groups, labels allow you to control which records a user group can access—without altering the underlying data structure. This ensures that users only see the data relevant to them, based on your chosen grouping criteria such as location, department, or customer type.

Label filtering works across all application interfaces and widgets, meaning the data shown to a user group will always match the filters you configure.

Filtering Data by User Groups with Labels

How it Works

Every application user in Rayven must belong to a user group.
When configuring a user group, you can set label-based filters that determine which Primary Table rows the group’s members can access.

For example:

Primary Table Label: Region
Label Values: Sydney, Melbourne, Brisbane
User Group Filter: Region = Sydney

Any user in that group will only see data from rows where Region = Sydney.

Default Behaviour

By default, the Primary Label is set to All.
This means a newly created user group can see all rows in the Primary Table without additional filtering.
This is useful for applications where granular filtering is not needed.

Combining Filters

You can refine access further using AND and OR logic:

AND: Restricts results to rows matching all selected label values.
Example: Region = Sydney AND Department = Finance
OR: Expands results to rows matching any of the selected label values.
Example: Region = Sydney OR Region = Melbourne

Private vs Shared User Groups

Shared User Groups: All users see the same data and widget layouts.
Private User Groups: All users share the same interfaces and widget layouts, but each user sees only the data that relates to them (configured via label filters for each user).

Location & Icon Settings

When you click a label value in a user group’s filter settings, an advanced settings menu appears.
Here you can:

Assign a geographic location (lat/long)
Choose a map icon to represent that location in a Map node
Set a time zone for the label value

Impact on Interfaces

Once label filtering is applied:

All widgets on all interfaces will only show data that matches the user group’s label filter.
This applies to both pre-built widgets and custom UI Code widgets (if they rely on Primary Table data).

User Group filters using AND logic:

User Group filters using OR logic

Summary

Using labels to filter data by user groups in Rayven allows you to:

Ensure users see only the data relevant to them
Apply complex multi-label filters with AND/OR logic
Control data visibility across all interfaces without restructuring your tables
Optionally add geographic, icon, and time zone metadata for location-based applications

Default settings keep things simple for cases where filtering is not required, but the flexibility is there when you need it.

FAQs

Can I filter data for only some interfaces but not others?
No. Label filtering applies at the user group level and affects all interfaces that group can access.

What happens if I don’t configure any label filters for a user group?
The default Primary Label = All setting will apply, and the group will see all rows in the Primary Table.

Can I change label filters after users have been added to a group?
Yes. Updating the label filter in the user group will instantly change the data visibility for all users in that group.

Do label filters affect Secondary Tables?
Indirectly. If a Secondary Table is linked to the Primary Table by UID or label, the filtered data set will apply to related records.