Overview


In LINQ, roles are designed to ensure that users have the appropriate level of access and permissions to perform their tasks effectively. 


LINQ offers a flexible user management system designed to support collaboration within the platform. Each user can be assigned a specific role, granting them tailored access and permissions to perform various tasks. Users can be assigned roles at three distinct levels: 


1. Organisation level

2. Model level 

3. Project level


At each level, roles determine the actions a user can perform and are classified into three categories:

  • Admin: Full access and control.  Manages user's access.  Responsible for maintaining governance within LINQ.  
  • Write: Ability to create and modify, with specific limitations.
  • Read-Only: View-only access.

These roles ensure that users have appropriate permissions to perform their tasks while maintaining the integrity and security of organisational data. 


The following sections outline the responsibilities and capabilities of each role at the organisation, model, and project levels.  Each role builds on the capabilities of the preceding role, i.e., Admin roles can do everything Write roles can do.    


User Roles and Permissons

Organisation and Model/Project Roles Table 

The table below outlines the responsibilities and capabilities of each role at the organisation, model, and project levels. Each role builds on the permissions of the preceding role, meaning Admin roles encompass all Write and Read-only capabilities, and Write roles include all Read-only permissions. 


Access Level 
Admin
Write
Read-only
Organisation Level



Manage user access 
✅
❌
❌
View models and projects 
✅

✅

✅
Create models/projects
✅

✅

❌

Edit models/projects
✅

✅

❌

Delete/archive models
✅
 (all models, including those created by Write users)
❌ 

❌

Download models (e.g., JSON)
✅
✅

✅

Edit organisation details
✅
❌ 

❌

Add/update metadata
✅

✅

❌
Add emission factors
✅

❌
 
❌

Model/Project Level



View assigned models/projects
✅

✅

✅

Manage model/project access
✅

❌

❌

Create models/projects
✅

✅

❌

Edit models/projects 
✅

✅

❌

Delete/archive models or projects
✅


❌ 

❌
Download models/projects (e.g., JSON)
✅

✅
✅



Setting Roles in LINQ

This section provides step-by-step instructions on how to assign roles within LINQ at the Organisation, Model, and Project levels.


  • Steps to Set Roles for Organisation Level:

Step 1: The Organisation Admin Creates the Organisation

  1. Log in as an Organisation Admin. 
  2. Click on the Create Organisation button. 

3. Fill in the organisation details, including Name: Enter the organisation's name; Industry: Select the relevant industry type, start date and expire date.  


Step 2: Invite Users to the Organisation 


  1. Navigate to the Organisation Users Card. Click on the Invite User button.  
  2. Enter the name of the user you want to invite, provide the user's email address and select their organisation role from the dropdown menu.  
  3. Click Save to send the invitation. The invited user will receive an email to complete their registration and join the organisation with the assigned role. 


  • Steps to Set Roles for Model and Project Level


When creating a new model or project:

1. Navigate to Models Card, or Organisation projects Card, click the Create model button or Create project button.

2. Fill in the required details for creating the current state model, and project (future state).  

3. Assign user roles by scroll to the User access to model or Project access, locate the list of users displayed by name and email.  Click the dropdown menu under the Role column for each user to assign the desired role.


  • Steps to Set Roles for Existing Models and Projects

1. Locate the existing model or project from Models Card, or Organisation projects Card.  Click the Pen Icon.

2. Scroll to the User access to model or Project access, use the dropdown menu under the Role column for each user to update their role. Once you’ve updated the roles, click the Save button at the bottom of the page to apply the changes.