Fabritec Docs
English
  • English
  • Arabic
Learning Center
Support CenterChangelogAPI
Learning Center
Support CenterChangelogAPI
English
  • English
  • Arabic
English
  • English
  • Arabic
  1. Users & Permissions
  • Getting Started
    • Introductions
    • Installing Fabritec as a Desktop or Mobile App
    • User Profile & Change Language
    • Notification Settings and Push Notifications
    • Home
  • Administration & Setup
    • Company Setup
      • Company Profile
      • Preferences
      • License Info
      • Settings
    • Users & Permissions
      • Roles
      • Departments
      • Users
      • Logs
  • Production Setup
    • Production Stages
    • WorkStations
    • Workstation Groups
    • Categories
    • Routes
  • Workforce & Scheduling
    • Daily Operations
      • Shift Calendars
      • Timesheets
    • People
      • Labours
      • Labour Titles
      • Labour Group
      • Crews and Shift Rotations
    • Schedule Rules
      • Shifts
      • Work Calendars
      • Holidays
  • CRM
    • Introduction to CRM
    • Forecast Dashboard
    • CRM Pipeline and Enquiry Management
    • CRM Quotations
    • CRM Customers
    • CRM Analytics
    • CRM Settings
  • Projects
    • Customer & Project Basics
      • Contacts
      • Create New Project
      • Overview
      • Details
      • Buildings
    • Documents & Communication
      • Documents
      • Messages
    • Phases, Items & Revisions
      • Phases
      • Phases Explorer
      • Schemas for Excel and CSV Import
      • Phases Explorer: Manual Item Entry, Drawing Validation, and Smart Allocation
      • Revisions: Bulk Paint Update & Selective Item Deletion
    • Routing & Production
      • Routing Setup
      • Tracking
    • Project Quality Control
      • Quality Control
    • Project Shipping
      • Shipping Status
      • Shipping
    • Site Completion
      • Erection
    • 3D model
      • 3D model viewer
  • Production Execution
    • Production
    • Production Access
    • Production Logs
    • Revert & Refabricate Items in Production
  • Tasks Managment
    • Task Manager
    • Task Templates
    • Task Schedule View
  • Documents Module
    • Documents
  • Quality Control
    • Inspections
    • Quality Control Access
  • Shipping & Delivery
    • Shipping Yard
    • Shipping Calendar
  • Maintenance
    • Maintenance Workstations
    • Maintenance Orders
    • Maintenance parts cost analytics
    • Maintenance Plans
    • Planning Calendar
  • Insights, Reports & AI
    • Dashboards
    • Reports
    • Connecting Fabritec with AI Assistants: Claude AI and ChatGPT
    • Productivity
      • Workstation Productivity
      • Andon Board
      • Labour Productivity
      • Production Stage Productivity
  • Fabritec Workflow
    • Fabritec Project Lifecycle workflow
    • Fabritec Dashboards and Reports workflow
    • Production Setup & User Management Workflow
  1. Users & Permissions

Roles

Roles allow you to define user access levels and control permissions across Fabritec.
By assigning permissions that match each user's responsibilities, you help users access the information and actions they need without granting unnecessary control over other workflows.
Roles support system security, clear responsibility boundaries, consistent access management, and collaboration across departments.
Roles page

What Are Roles?#

A Role is a defined set of permissions that can be assigned to one or more users.
The selected permissions determine which system areas and actions the role provides access to. Depending on the permissions assigned, users can view information, manage records, update production, perform inspections, approve work, or carry out other authorized actions.
A role can have one user, multiple users, or no users assigned yet.

Examples of Roles#

Example Role NameTypical Responsibility
System AdminBroad system administration, when the required permissions are assigned
Workstation OperatorRecording production progress
Shipping CoordinatorManaging shipping workflows
Project ManagerOverseeing projects and buildings
Quality Control InspectorPerforming and reviewing quality inspections
Planning EngineerManaging routing setup and preparing cutting lists
Production ManagerOverseeing production operations and progress
MaintenanceManaging workstation maintenance
Sales RepCreating and following up enquiries
CRM ManagerManaging CRM activities and the appropriate enquiry visibility
Important: These are examples of job-based roles, not a guarantee of the permissions included in an existing role. Review the role's selected permissions rather than relying on its name.

Where to Find Roles#

Navigate to:
User Management → Roles
The User Management menu contains Users, Departments, Roles, and Logs.
The Roles page displays the description:
Define and assign specific roles to manage system access and responsibilities.

Roles List#

ColumnDescription
NameThe name of the role
UsersIcons representing users assigned to the role; a dash indicates that no users are assigned
ActionsControls for viewing permissions, editing the role, or deleting it

Page Controls#

ControlPurpose
Add RoleOpens the form for creating a role
Excel ExportExports the roles list to Excel
PDF ExportExports the roles list to PDF
Clear filterClears the applied table filters
SearchFinds roles by name
Name column filterFilters the list using the role name
ColumnsLets you choose which table columns to display
Items per pageChanges the number of roles displayed on each page
Page navigationMoves between pages of roles
The toolbar also includes a Reset cache control.
To locate a role, enter its name in Search or use the filter icon in the Name column. Clear the search text and applied filters when returning to the broader list.

Permissions for Role Administration#

View Roles and Manage Roles are separate permissions.
View Roles provides access to viewing roles and their permissions. Manage Roles provides access to managing roles and their permissions.
User and department administration is controlled separately through Manage Users and Departments.

Add a New Role#

Click Add Role in the upper-right corner of the page.
The Add Role form contains Name, Description, and Permissions, followed by the Add button.
Add Role form

Name — Required#

Enter a clear, descriptive name that identifies the role's responsibilities.
Examples include Production Manager, QC Inspector, and Shipping Coordinator.
Use names that help administrators distinguish roles without opening each one. Avoid creating several similarly named roles unless their responsibilities and permissions are clearly different.

Description — Optional#

Enter a brief explanation of the role's responsibilities.
For example:
Performs quality inspections and reviews inspection results and quality-control reports.
Use the description to explain the intended responsibility. Configure the actual access in Permissions.

Permissions — Required#

Open the Select Permissions dropdown and choose the system areas and actions the role requires.
Review permissions against the user's work: what they need to view, what they need to change, and whether they are responsible for approvals or access administration.
You can select permissions individually or use Select All to select all available permissions.
Important: Use Select All only when the role intentionally requires every available permission. Do not use it as the default for operational roles.

Permission Reference#

The following reference contains 95 permissions across 15 groups, following the permission catalog reviewed on 13 September 2026.
It lists permission labels and their purposes, not the permissions assigned to every role. Check the available options in your deployed role editor when configuring access.
The groups follow the catalog's organization rather than matching every item in the navigation menu. For example, Production includes maintenance and productivity permissions, Projects and Buildings includes customer permissions, and Erection includes Confirm Delivery.

User Management#

PermissionPurpose
Manage Users and DepartmentsManage users and departments.
View Users and DepartmentsView users and departments.
Manage RolesManage roles and their permissions.
View RolesView roles and their permissions.
View LogsView application audit logs.
Access distinction: Viewing roles and managing roles are separate permissions. Grant role-management access only to users responsible for maintaining access permissions.

Settings#

PermissionPurpose
Manage Company ProfileManage company profile information.
Manage License InfoManage license information.
Manage PreferencesManage measurement units, rounding, and other system preferences.
Manage IntegrationsManage external API and AI integration clients.
Manage CurrenciesManage currencies, the base currency, and exchange rates.
View Company ProfileView company profile information.
View PreferencesView measurement units, rounding, and other system preferences.

Production Setup#

PermissionPurpose
Manage Production Stages and WorkStationsManage production stages and workstations.
View Production Stages and WorkStationsView production stages and workstations.
Manage Categories and RoutesManage production categories and routes.
View Categories and RoutesView production categories and routes.

Workforce#

PermissionPurpose
Manage LaboursManage labours, labour groups, and labour titles.
View LaboursView labours, labour groups, and labour titles.
Manage CrewsManage crews, members, fixed shifts, and shift rotations.
View CrewsView crews, members, fixed shifts, and shift rotations.
Manage ShiftsManage shift definitions, daily assignments, and scheduling overrides.
View ShiftsView shift calendars, assignments, and definitions.
Manage Work CalendarsManage work calendars, holidays, and scheduling defaults.
View Work CalendarsView work calendars, patterns, exceptions, and holidays.
View TimesheetsView derived labour timesheets.
Approve TimesheetsApprove and reopen labour timesheet days.
View Timesheets and Approve Timesheets cover different responsibilities: reviewing timesheet information is separate from approving or reopening timesheet days.

Projects and Buildings#

PermissionPurpose
Manage ProjectsCreate, edit, close, and manage projects.
View CustomersView customer master data and insights.
Manage CustomersCreate, edit, and manage customers.
Manage BuildingsCreate, edit, and manage buildings.

Phases and Revisions#

PermissionPurpose
Manage PhasesCreate, edit, and manage phases.
Release Phase for ProductionRelease phases for production.
Release Phase for ShippingRelease phases for shipping.
Add RevisionsAdd revisions to phases.
View RevisionsView revision details.
Open Phase for RevisionOpen a phase for revision after its initial revision.
Review RevisionsReview and approve revisions.
View BOM ReportsView Bill of Materials reports and related information.

Production#

PermissionPurpose
Manage MaintenanceCreate, edit, schedule, and progress workstation maintenance.
View Maintenance OrdersView maintenance orders, the order board, and maintenance calendar.
View Maintenance PlansView preventive maintenance plans and workstation due forecasts.
View Maintenance KPIsView maintenance KPIs, downtime insights, and maintenance widgets.
View Maintenance CostsView planned and actual maintenance parts costs and cost analytics.
Manage Maintenance CostsRecord, correct, and finalize maintenance parts costs.
Report Maintenance IssueReport a workstation breakdown without full maintenance-management access.
View Workstation and Stage ProductivityView workstation and stage productivity, utilization, bottlenecks, and the Andon board.
View Labour ProductivityView crew summaries, named labour productivity, and individual labour details.
Manage Routing SetupManage item routing setups.
View TrackingView production tracking details.
Update Production ProgressRecord production progress.
Modify Production AccessManage production access for users who have permission to update progress.
Update Production Progress With OverridesUpdate production progress using old dates.
Create Patches and Cutting ListsCreate production patches and cutting lists.
Manage Stock ItemsManage stock items, including marking them available for shipping.
Manage Outsourcing ItemsManage the outsourcing process for items.
Hold And Reset ItemsHold, reset, or revert items.
Modify Production LogsModify or delete production logs.
View Production LogsView production logs.

Production Access and Overrides#

Update Production Progress allows production recording. Modify Production Access controls production access for users who have permission to update progress. Review operational assignments as well as the role's permission selections.
Update Production Progress With Overrides is described in the catalog as allowing production updates using old dates. Do not interpret its name as permission to bypass every production rule.
Report Maintenance Issue allows a workstation breakdown to be reported without full maintenance-management access. Maintenance costs also have separate View Maintenance Costs and Manage Maintenance Costs permissions.
Terminology: Create Patches and Cutting Lists is the permission's exact label. Look for this wording in the permission selector.

Quality Control#

PermissionPurpose
Perform InspectionsPerform quality inspections.
View InspectionsView inspection results and details.
Manage QC AccessManage QC access for users who have permission to perform inspections.
View QC ReportsView quality-control reports and insights.
Perform Inspections and Manage QC Access are separate permissions. Performing inspections is different from administering QC access for other inspection users. Review the relevant QC assignments during onboarding.

Shipping#

PermissionPurpose
Confirm Shipping Yard EntranceConfirm that items have entered the shipping yard.
Dispatch ManagementCreate and manage dispatches.
Dispatch ShippingConfirm shipping of a dispatch.
Return DispatchesReturn shipped or delivered dispatches to the shipping yard.
View ShippingView shipping-yard, shipping, and dispatch information.
Dispatch NotificationsReceive dispatch-related notifications.
Dispatch Management, Dispatch Shipping, and Return Dispatches are separate permissions. Creating a dispatch, confirming its shipment, and returning it to the shipping yard are different responsibilities.

Document Management#

PermissionPurpose
Manage Project Documents StructureManage the folder structure used when a project is created.
View Project Documents StructureView the folder structure used when a project is created.
Upload FilesUpload files to the system.
View FilesView files and documents.

Chat#

PermissionPurpose
View ChatView messages in project group chats.
Write ChatWrite messages in project group chats.

Insights#

PermissionPurpose
Productivity InsightsView production widgets, productivity dashboards, and production reports.
Quality Control InsightsView quality-control and rework widgets.
Shipping InsightsView shipping widgets and shipping reports.
Project InsightsView project-insight widgets.

Task Management#

PermissionPurpose
Manage Task WorkFlowsManage task workflows and statuses.
Manage Task TagsView, edit, and delete task tags.
Manage Task MembersManage task-member assignment permissions.
View Task MembersView task-member assignment permissions.
View Archived TasksView archived tasks.

Erection#

PermissionPurpose
Confirm DeliveryConfirm delivery.
Update ErectionUpdate erection or installation progress.
View ErectionView erection or installation details.
Confirm Delivery belongs to the Erection permission group. It is distinct from Dispatch Shipping, which confirms shipping of a dispatch.

CRM#

PermissionPurpose
View CRM DashboardView CRM forecast dashboards and analytics.
View CRM PipelineView enquiries, pipeline lists, and customer views.
Create and Edit Own EnquiriesCreate enquiries and edit enquiries owned by the user.
Edit All EnquiriesEdit enquiries within the user's visibility scope.
Change Enquiry StatusMove enquiries through statuses and close outcomes.
Convert Enquiry to ProjectConvert a won enquiry into a project.
Manage CRM SettingsManage CRM statuses, lookups, defaults, and numbering.
View Team CRM DataView CRM records owned by the user's department.
View All CRM DataView all CRM records in the tenant.
Important: Edit All Enquiries is limited to the user's visibility scope. It does not independently provide visibility of every enquiry in the tenant.
View Team CRM Data provides visibility of records owned by the user's department. View All CRM Data provides visibility of all CRM records in the tenant. Review editing permissions and data-visibility permissions separately.

Saving the Role#

After completing Name and Permissions, review the selected access and click Add.
The new role appears in the Roles list and becomes available for assignment through the Users page.
Creating a role and assigning it to users are separate steps. The Add Role form does not include a user-assignment field.

Assigning Users to Roles#

Users are linked to roles through:
User Management → Users
Create or edit the relevant user account, assign the required role, and save the user changes.
Return to User Management → Roles to review the Users column. Assigned user icons appear beside the role.
A role with no assigned users remains available for future assignment.
Before assignment: Review the role's permissions using the View action. Confirm that the role matches the user's actual responsibilities.
For production and QC users, review the relevant operational access assignments as well as the role. For CRM users, check whether their work requires department-level or tenant-wide data visibility.

Viewing a Role's Permissions#

In the Actions column, click the eye icon beside the role.
Use this action to review the permissions assigned to the role before assigning it to a user or changing its configuration.
This is also useful when two roles have similar names but provide different access.

Editing a Role#

In the Actions column, click the pencil icon beside the role.
You can modify the role's name, description, or permissions.
Review the users assigned to the role before making changes. A shared role should continue to match the responsibilities of the people who use it.
Save the changes after reviewing the revised permission selection.
Important: Treat a change to a shared role as an access change that may affect every user assigned to it. Inform the affected team before removing permissions required for active work.

Deleting a Role#

In the Actions column, use the trash icon to delete a role that is no longer required.
A role cannot be deleted while it is assigned to users. Reassign those users first.
To remove an unused role:
1.
Locate the role and review its Users column.
2.
When users are assigned, go to User Management → Users, assign them an appropriate replacement role, and save the changes.
3.
Return to Roles and confirm that the original role has no assigned users.
4.
Click the role's Delete action.
Review the replacement role before reassigning users so that they retain the access required for their work.

Best Practices#

Create Roles Around Real Job Functions#

Define roles around responsibilities such as production recording, quality inspection, planning, shipping coordination, maintenance, and CRM follow-up.
Use clear names and descriptions so another administrator can understand each role's purpose.

Grant Only the Permissions Required#

Avoid giving users unnecessary administrative, approval, or modification permissions.
Keep Select All and broad administrative roles for users whose responsibilities genuinely require that level of access.

Separate Operational Work from Access Administration#

Updating production is different from modifying production access. Performing inspections is different from managing QC access.
Likewise, creating a dispatch is different from confirming shipment or returning a dispatch.

Review Shared Roles and Assignments Regularly#

Check roles when users change responsibilities and before editing a role shared by several people.
Review both the selected permissions and the users assigned to the role. For CRM, include a separate check of data visibility.
Reassign users before deleting an obsolete role, and avoid maintaining multiple roles with unclear or overlapping purposes.

🔗 Related Articles#

Users – Create and manage system users
Departments – Group users for better organization
Production Setup – Permissions related to production configuration
Projects & Phases – Permissions associated with project workflows
Modified at 2026-09-16 08:14:35
Previous
Settings
Next
Departments
Built with