Roles Overview
This article explains how roles and permissions work in Model Reef.
You will learn:
The three core roles: Owner, Editor and Viewer.
How access can be granted at model level and branch level.
How roles and permissions interact with collaboration tools such as notes, tags and attachments.
Model Reef is designed so that teams can collaborate on complex models without losing control of who can see and change what.
Role types in Model Reef
Model Reef uses three main role types:
Owner Full control over the model, including structure, settings and permissions.
Editor Can change assumptions, variables and structure in the areas they have been given access to.
Viewer Read only access to the areas they have been given access to.
These roles can be applied at the entire model level or at specific branch levels.
Model level vs branch level permissions
There are two layers of access control:
Model level permissions Control access to the entire model. If a user is made an Owner, Editor or Viewer at model level, they can see the whole model.
Branch level permissions Control access to specific parts of the branch tree. A user can be given Editor or Viewer access only to certain branches and their children.
Branch level permissions are useful when:
Different teams are responsible for different entities, divisions or projects.
You want external collaborators to see only a subset of the model.
You want to isolate work while still sharing high level outputs.
What each role can do
At a high level:
Owners can:
Change anything in the model.
Invite and remove collaborators.
Change roles and branch access.
Archive or delete the model.
Editors can:
Modify variables, drivers and timing in branches they have access to.
Add notes, comments, tags and attachments.
Create new branches inside their allowed sections.
View all outputs for the branches they can see.
Viewers can:
See dashboards, reports and variables in branches they have access to.
Read notes and attachments.
Cannot change any assumptions or structure.
The detailed behaviour of each role is covered in the role specific help articles.
Collaboration tools and roles
Role permissions also govern access to collaboration features:
Only Editors and Owners can create or edit notes and comments.
Viewers can read notes and comments but cannot change them.
Tags and attachments are visible according to branch access and role.
Archive rules are controlled by Owners.
This ensures that review comments and documentation remain attached to the correct parts of the model without exposing the entire model to every collaborator.
Related articles
Last updated