Skip to main content

Permission matrix

This page lists every permission seeded into a workspace and shows which of the six default roles holds it. Use it as the reference when configuring custom roles or auditing access.

How the matrix is enforced​

  • Workspace-scoped. Roles and their permission grants live per workspace (per companyId). Every seeded workspace gets its own copy of the six default roles, and every tenant query is scoped to the workspace by a tenant guard, so a permission grant in one workspace never leaks into another. The platform operator manages workspaces from a separate /operator console that does not use this matrix at all.
  • Grants, not hard-coding. A user's effective permissions are the union of the grants on every role assigned to them. Endpoints are protected with a permissions decorator, and the guard checks that the caller actually holds the required permission — there is no implicit Super Admin bypass. Super Admin can do everything only because it is seeded with the full permission set.
  • Fixed for the six default roles. The six default roles are system roles: their grants cannot be changed, from the access-control screen or the API. To give someone a different set, Duplicate the nearest default role into a custom role, adjust it, and assign that instead. The matrix shows the grants a new workspace starts with.
Country packs affect which permissions matter

Payroll, tax, and statutory rules follow the workspace's country pack, so some financial permissions only do something under certain packs. For example tax.configure / tax.certificates drive income-tax handling for a pack that has income tax (such as the Pakistan pack), but carry no tax logic under a pack with no income tax (such as the UAE pack). The permission still exists everywhere; the behaviour behind it is pack-dependent.

Legend: SA = Super Admin, HRM = HR Manager, HRO = HR Officer, ACC = Accountant, DH = Department Head, EMP = Employee.

Company​

PermissionDescriptionSAHRMHROACCDHEMP
company.viewView company profile and settings✅✅✅✅❌❌
company.updateUpdate company profile✅❌❌❌❌❌
company.settingsManage workspace settings (also gates badge evaluation, manual awards, address-verification admin actions, Billing, and the AI assistant's Usage & credits page; holders have no personal AI credit limit)✅✅❌❌❌❌

Work locations​

PermissionDescriptionSAHRMHROACCDHEMP
work_locations.viewSee the workspace's work locations and who is where today; set one's own weekly pattern and day exceptions✅✅✅✅✅✅
work_locations.manageCreate, edit and delete work locations; set any employee's default location, weekly pattern and exceptions✅✅✅❌❌❌

People directory​

PermissionDescriptionSAHRMHROACCDHEMP
directory.viewSee the people directory, each person's card with their reporting line, and the whole workspace's org chart in the portal; write one's own "About" line✅✅✅✅✅✅

The directory's switches are saved with company.settings. See People directory.

Portal Home​

No permission of its own. Everyone with employees.view_own reads Home, and each person can leave themselves out of Celebrations. Its sections, banner and quick links are arranged with company.settings. See Portal Home.

Employees​

PermissionDescriptionSAHRMHROACCDHEMP
employees.view_allView all employee records✅✅✅✅❌❌
employees.view_teamView team (department) employees✅✅✅✅✅❌
employees.view_ownView own employee profile✅✅✅✅✅✅
employees.createCreate new employees, and rehire former ones✅✅✅❌❌❌
employees.updateUpdate employee records✅✅✅❌❌❌
employees.deleteDelete employees✅✅❌❌❌❌
employees.importBulk-import employees✅✅❌❌❌❌
employees.confirmConfirm an employee after probation (auto-issues confirmation letter + sends the confirmed email)✅✅❌❌❌❌

Skills​

These do something only in a workspace with the Skills management feature, which comes with the Growth and Enterprise plans. See Skills.

PermissionDescriptionSAHRMHROACCDHEMP
skills.viewRead the skills library, people's skills and résumés, the skills matrix and its export, expiring and lapsed certifications, and the skills a designation requires✅✅✅❌✅❌
skills.manageEdit the library and skill types, people's skills and résumé entries, and the skills a designation or opening requires; review the skills and résumé entries employees propose; receive the certification-expiry email✅✅❌❌❌❌
skills.view_ownSee one's own skills and résumé on the portal profile, and propose changes for HR to review✅✅✅✅✅✅

Documents​

PermissionDescriptionSAHRMHROACCDHEMP
documents.view_allView all employee documents✅✅✅❌❌❌
documents.view_ownView own documents✅✅✅❌❌✅
documents.uploadUpload documents✅✅✅❌❌✅
documents.verifyVerify documents✅✅✅❌❌❌

Company documents​

PermissionDescriptionSAHRMHROACCDHEMP
company_documents.viewRead the company documents shared with one, and acknowledge the ones that ask for it (Portal › Company Documents)✅✅✅✅✅✅
company_documents.manageManage the company document library: add, edit, attach files, publish, archive, delete drafts, and see who has acknowledged✅✅✅❌❌❌

Contracts​

PermissionDescriptionSAHRMHROACCDHEMP
contracts.viewView employment contracts✅✅✅✅❌❌
contracts.createCreate employment contracts✅✅✅❌❌❌
contracts.updateUpdate contracts (witness data, signed-copy upload)✅✅❌❌❌❌
Employee agreement portal bypasses the matrix

The employment-agreement portal endpoints (GET /api/contracts/portal/my-contract and POST /api/contracts/portal/my-contract/accept) do not require any of the permissions above. They authorize solely on the authenticated user being linked to an employee record, so an employee can only ever read or accept their own contract regardless of role.

Attendance​

PermissionDescriptionSAHRMHROACCDHEMP
attendance.view_allView all attendance records✅✅✅✅❌❌
attendance.view_teamView team (department) attendance✅✅✅✅✅❌
attendance.view_ownView own attendance✅✅✅✅✅✅
attendance.markMark or edit attendance✅✅✅❌❌❌
attendance.bulk_markBulk-mark attendance✅✅❌❌❌❌
attendance.regularize_approveApprove regularization requests✅✅❌❌✅❌
attendance.regularize_requestRequest regularization✅✅✅✅✅✅
attendance.overtime_approveApprove overtime✅✅❌❌✅❌
attendance.manageManage attendance settings and shifts✅❌❌❌❌❌
attendance.geo_manageManage geo attendance locations and assignments✅✅❌❌❌❌
attendance.kiosk_manageManage kiosk tablets: add, rename, re-pair, release and delete devices; set or clear anyone's kiosk PIN (needs the Scheduling feature)✅✅❌❌❌❌

Roster​

These do something only in a workspace with the Scheduling feature, which comes with the Growth and Enterprise plans. See Attendance → Roster.

PermissionDescriptionSAHRMHROACCDHEMP
roster.viewOpen the roster week, patterns, rules, swaps and drops, and the scheduled-vs-actual report (direct reports only without attendance.view_all)✅✅✅❌✅❌
roster.manageEdit cells, copy a week and clear entries; create and assign patterns; change the rules✅✅✅❌❌❌
roster.publishPublish and unpublish the roster; approve or reject swaps and drops✅✅❌❌❌❌
roster.view_ownSee one's own published schedule (Portal › My Schedule)✅✅✅✅✅✅
roster.swap_requestOffer, take, accept, decline or cancel a swap or drop✅✅✅✅✅✅

Field Visits​

PermissionDescriptionSAHRMHROACCDHEMP
field_visits.viewView field visits, the map, clients and settings✅✅✅❌❌❌
field_visits.manageManage clients and pins, enrol field staff, settings, close/cancel visits✅✅❌❌❌❌

Timesheets​

These do something only in a workspace with the Timesheets feature, which comes with the Growth and Enterprise plans. See Timesheets.

PermissionDescriptionSAHRMHROACCDHEMP
timesheets.view_ownFill in, save, submit and withdraw one's own weekly timesheet; see the project list✅✅✅✅✅✅
timesheets.approveTeam Timesheets: read, approve and return the direct reports' weeks✅✅✅❌✅❌
timesheets.manageProjects and their tasks, timesheet settings, every week in the workspace (approve or return any), and the hours report✅✅✅❌❌❌

Leave​

PermissionDescriptionSAHRMHROACCDHEMP
leave.view_allView all leave applications✅✅✅❌❌❌
leave.view_teamView team (department) leave records✅✅✅❌✅❌
leave.view_ownView own leave balance and history✅✅✅✅✅✅
leave.applyApply for leave✅✅✅✅✅✅
leave.approveApprove or reject leave applications✅✅❌❌✅❌
leave.configureConfigure leave policies✅✅❌❌❌❌
leave.allocateAllocate leave balances✅❌❌❌❌❌

Approval flows​

Who decides a request is set by its flow's steps, not by these two. The Approvals inbox and My requests need no permission. See Approval flows.

PermissionDescriptionSAHRMHROACCDHEMP
approvals.configureOpen the Approval flows page and test a flow; create, edit and delete flows (with the Custom approval flows feature); see any request's chain✅✅❌❌❌❌
approvals.delegateHand one's own pending approvals to a colleague for a period (creating a delegation needs the Custom approval flows feature)✅✅✅✅✅❌

Payroll​

PermissionDescriptionSAHRMHROACCDHEMP
payroll.viewView payroll runs and entries✅✅❌✅❌❌
payroll.processProcess monthly payroll, dry-run it, and pause or resume an employee's pay; also lets a salary change update a payroll still open✅✅❌✅❌❌
payroll.approveApprove a payroll run✅✅❌❌❌❌
payroll.lockLock (finalize) a payroll run✅❌❌✅❌❌
payroll.salary_view_allView all employees' salaries, the PF ledger and contribution funds✅✅❌✅❌❌
payroll.salary_view_ownView own salary✅✅✅✅✅✅
payroll.salary_assignAssign salaries / structures, adjustments, increments; delete a salary record entered by mistake✅✅❌✅❌❌
payroll.configureConfigure payroll (components, structures)✅✅❌❌❌❌
payroll.manageDisburse, finalize, mark-paid, hold and release a salary, salary-history import, set up contribution funds, record their entries, and share fund profit with members (or undo a share)✅❌❌✅❌❌
payroll.adjustment_deleteHard-delete a payroll adjustment (irreversible)✅❌❌❌❌❌

Salary slips​

PermissionDescriptionSAHRMHROACCDHEMP
salary_slips.generateGenerate salary slips for a payroll run✅✅❌✅❌❌
salary_slips.view_allView all employees' salary slips✅✅❌✅❌❌
salary_slips.view_ownView own salary slips✅✅✅✅✅✅
salary_slips.emailEmail salary slips✅✅❌✅❌❌

Cheques​

PermissionDescriptionSAHRMHROACCDHEMP
cheques.manageOpen the cheque register and mark cheques cleared; with payroll.manage, also issue, bounce and cancel them✅❌❌✅❌❌
cheques.printPrint and reprint cheques for a locked payroll run✅❌❌✅❌❌

Tax​

Tax handling is driven by the workspace's country pack (see the note at the top).

PermissionDescriptionSAHRMHROACCDHEMP
tax.configureConfigure tax (slabs / rates for the active pack)✅✅❌✅❌❌
tax.certificatesManage and generate tax certificates✅✅❌✅❌❌
tax.view_ownView own tax details and certificate✅✅✅✅✅✅

Loans​

PermissionDescriptionSAHRMHROACCDHEMP
loans.view_allView all loan records✅✅❌✅❌❌
loans.view_ownView own loans and installment schedule✅✅✅✅✅✅
loans.applyApply for a loan✅✅✅✅✅✅
loans.approveApprove or reject loan applications✅✅❌✅❌❌
loans.configureConfigure loan types✅✅❌❌❌❌

Holidays​

PermissionDescriptionSAHRMHROACCDHEMP
holidays.manageCreate and delete holidays✅✅✅❌❌❌
holidays.viewView the holiday calendar✅✅✅✅✅✅

Announcements​

PermissionDescriptionSAHRMHROACCDHEMP
announcements.manageCreate, update, and delete announcements✅✅✅❌❌❌
announcements.viewView announcements✅✅✅✅✅✅

Company events​

PermissionDescriptionSAHRMHROACCDHEMP
events.viewSee the company events they are invited to, and reply✅✅✅✅✅✅
events.managePublish, change and cancel company events, and read the replies✅✅✅❌❌❌

Recognition​

These do something only on a plan with Performance. See Company events & recognition.

PermissionDescriptionSAHRMHROACCDHEMP
recognition.giveRead the recognition feed and recognise a colleague✅✅✅✅✅✅
recognition.manageChange the company values and remove a recognition✅✅✅❌❌❌

Learning​

These do something only on a plan with Learning. See Learning.

PermissionDescriptionSAHRMHROACCDHEMP
learning.takeTake the courses they are assigned or choose✅✅✅✅✅✅
learning.view_teamSee the course progress of the people who report directly to them✅✅✅❌✅❌
learning.manageWrite and assign courses, read the progress report, and allow another quiz attempt✅✅✅❌❌❌

Knowledge base​

See Knowledge base.

PermissionDescriptionSAHRMHROACCDHEMP
knowledge.viewRead and search the articles published for one, and acknowledge the ones that ask for it. The owner and the editors of a knowledge space also write, publish and review that space's articles with it✅✅✅✅✅✅
knowledge.manageWrite in every space: create and edit categories and articles; publish, review, archive and delete them; see who has acknowledged an article and its earlier versions. Add, rename and delete spaces, and choose their owners and editors✅✅✅❌❌❌

Surveys​

These do something only in a workspace with the Surveys feature, which comes with the Growth and Enterprise plans. See Surveys.

PermissionDescriptionSAHRMHROACCDHEMP
surveys.respondAnswer the surveys one is invited to (Portal › My Surveys)✅✅✅✅✅✅
surveys.manageBuild surveys; open and close them and invite people; read their results✅✅✅❌❌❌

Dashboard​

PermissionDescriptionSAHRMHROACCDHEMP
dashboard.adminAdmin dashboard✅❌❌❌❌❌
dashboard.personalPersonal dashboard✅❌❌❌❌❌

Reports​

PermissionDescriptionSAHRMHROACCDHEMP
reports.allView all reports✅✅❌✅❌❌
reports.departmentView department reports✅✅✅✅✅❌
reports.ownView own reports✅✅✅✅✅✅

Audit​

PermissionDescriptionSAHRMHROACCDHEMP
audit.viewView audit logs✅✅❌❌❌❌

Roles & users​

PermissionDescriptionSAHRMHROACCDHEMP
roles.manageCreate, update, and delete roles and their permissions✅❌❌❌❌❌
users.manageCreate, update, and deactivate user accounts and role assignments✅✅❌❌❌❌
users.impersonateSign in as another user✅❌❌❌❌❌
users.manage_2faReset a member's two-factor authentication✅❌❌❌❌❌

API keys​

PermissionDescriptionSAHRMHROACCDHEMP
api.manageManage API keys for the public tenant API (create, revoke, view usage)✅❌❌❌❌❌

HR letters​

PermissionDescriptionSAHRMHROACCDHEMP
hr_letters.manageGenerate, manage, and delete HR letters✅✅❌❌❌❌
hr_letters.view_ownView own HR letters✅✅✅❌✅✅
hr_letters.manage_requestsHandle employee letter requests✅✅✅❌❌❌
hr_letters.requestRequest an HR letter✅✅✅❌✅✅

Brand Studio​

These do something only in a workspace that has unlocked Brand Studio, which no plan includes. See Brand Studio.

PermissionDescriptionSAHRMHROACCDHEMP
brand_studio.manageManage the brand kit: logos, colours, card and signature layouts✅✅❌❌❌❌
brand_studio.issueIssue and revoke ID cards, print queues, visiting card orders, email signatures, employee requests✅✅✅❌❌❌
brand_studio.view_ownView own ID card, business card and email signature in the portal✅✅✅✅✅✅
brand_studio.requestRequest a replacement ID card or visiting cards from the portal✅✅✅✅✅✅

AI assistant​

This does something only in a workspace that has the AI assistant, which every paid plan includes. See AI assistant.

PermissionDescriptionSAHRMHROACCDHEMP
assistant.useUse the AI Assistant: open the chat. It adds no access of its own; the assistant can only do what the person's other permissions allow✅✅✅✅✅✅

Email templates​

PermissionDescriptionSAHRMHROACCDHEMP
email_templates.manageManage email templates✅❌❌❌❌❌

Print​

PermissionDescriptionSAHRMHROACCDHEMP
print.salary_slipsPrint / download salary slip PDFs✅✅❌✅❌✅
print.attendancePrint attendance✅✅✅✅✅✅
print.payroll_sheetPrint the payroll sheet✅✅❌✅❌❌
print.chequesPrint cheques✅❌❌✅❌❌
print.tax_certificatesPrint tax certificates✅✅❌✅❌❌
print.reportsPrint reports✅✅✅✅✅❌
print.contractsPrint contracts✅✅❌❌❌❌

Biometric devices​

PermissionDescriptionSAHRMHROACCDHEMP
biometric.viewView devices, users, punches, sync history, command log✅✅✅❌❌❌
biometric.manageRegister devices, sync, bind users, push time, restart, rotate comm key✅✅❌❌❌❌

System backups​

Backups cover the database and uploaded assets and are not workspace-scoped, so the grant is seeded to Super Admin only.

PermissionDescriptionSAHRMHROACCDHEMP
system_backup.viewView system backups✅❌❌❌❌❌
system_backup.manageCreate, restore, and manage system backups✅❌❌❌❌❌

SMS & mobile verification​

PermissionDescriptionSAHRMHROACCDHEMP
sms.manageManage SMS providers✅✅❌❌❌❌
mobile_verification.manageManage mobile-number verifications✅✅✅❌❌❌

Appraisals​

PermissionDescriptionSAHRMHROACCDHEMP
appraisals.configureManage appraisal settings (cadence, scale, toggles, auto-flow gate)✅✅❌❌❌❌
appraisals.manageBuild templates, run cycles, roll out, finalise, download PDFs, view all✅✅❌❌❌❌
appraisals.reviewAccess the manager review queue and submit reviews for direct reports✅✅❌❌✅❌
appraisals.view_ownView own appraisals and submit own self review✅✅✅✅✅✅

Assets​

PermissionDescriptionSAHRMHROACCDHEMP
assets.manageFull CRUD on assets and categories; issue and return assets✅✅✅❌❌❌
assets.view_allRead all workspace assets and assignment history✅✅✅✅✅❌
assets.view_ownView own assigned assets and personal history✅✅✅✅✅✅

Offboarding​

PermissionDescriptionSAHRMHROACCDHEMP
offboarding.manageInitiate separations, manage clearance, run final settlement✅✅❌❌❌❌
offboarding.viewRead separations, settlement preview, refresh live clearance✅✅✅✅❌❌

Onboarding​

PermissionDescriptionSAHRMHROACCDHEMP
onboarding.manageEdit pipelines and tasks, assign owners, run system actions✅✅✅❌❌❌
onboarding.viewRead pipelines and tasks✅✅✅✅✅❌

Activity plans​

PermissionDescriptionSAHRMHROACCDHEMP
activity_plans.viewRead the activity plans (onboarding, offboarding, transfer and promotion checklists) and their settings, and preview which plan a person would get✅✅✅❌✅❌
activity_plans.manageCreate, edit, reorder, duplicate and delete plans; change their settings; apply a plan to a checklist✅✅❌❌❌❌

Expense claims​

PermissionDescriptionSAHRMHROACCDHEMP
expenses.submit_ownCreate and edit own claims, upload receipts, track status✅✅✅✅✅✅
expenses.approve_teamManager queue — approve / reject direct reports' claims✅✅❌❌✅❌
expenses.manageConfigure categories and HR/finance final-approve any claim✅✅❌✅❌❌
expenses.view_allRead all claims across the workspace✅✅✅✅❌❌

Recruitment / ATS​

Recruitment permissions are seeded to Super Admin only by default. When you roll the module out, give them to a custom role (a duplicate of HR Manager, say) from the access-control screen.

PermissionDescriptionSAHRMHROACCDHEMP
recruitment.manageManage jobs, postings, candidates, applications, interviews, offers, convert to employee✅❌❌❌❌❌
recruitment.interviewSubmit interview feedback (participant gate enforced in the service)✅❌❌❌❌❌
recruitment.viewRead openings, candidates, applications (no edits)✅❌❌❌❌❌

Performance tracking​

PermissionDescriptionSAHRMHROACCDHEMP
performance.manageConfigure the performance module (settings, scorecard profiles, any task); override daily-report AI verdicts; triage AI-flagged reviews and void scores; link integration identities✅✅❌❌❌❌
performance.reviewAssign and grade tasks. Team-scoped on its own: reaches only the holder's direct reports; combined with performance.manage or performance.view_all it becomes company-wide. Recurring task schedules always require the company-wide combination✅✅❌❌✅❌
performance.view_allView all employees' performance scores✅✅✅❌❌❌
performance.view_ownView own tasks and score, submit daily reports✅✅✅✅✅✅

Goals and 1:1s​

These do something only in a workspace with the Performance feature.

PermissionDescriptionSAHRMHROACCDHEMP
goals.view_ownOwn goals and check-ins, the alignment view, and one's 1:1s✅✅✅✅✅✅
goals.manage_teamSet and read the direct reports' goals (private ones included), confirm the goals they set themselves, hold 1:1s with them✅✅❌❌✅❌
goals.manageCompany and department goals, every individual goal that is not private, and confirming a self-set goal that is not private✅✅✅❌❌❌

Performance integrations (GitHub / WHMCS)​

The /admin/integrations surface is plan-gated on the performance feature. Connection plumbing and merit governance are split:

ActionPermissionSAHRMHROACCDHEMP
Connections: save credentials, choose repos, test, poll, AI-provider CRUDcompany.settings✅✅❌❌❌❌
Merit governance: identities list/link/unlink, flagged-review triage, score voidperformance.manage✅✅❌❌❌❌

Self-service (view_own / *_own) endpoints​

The employee portal reads a user's own data through the view_own / *_own permissions (for example employees.view_own, attendance.view_own, leave.view_own, payroll.salary_view_own, salary_slips.view_own, loans.view_own, hr_letters.view_own, assets.view_own, expenses.submit_own, performance.view_own, goals.view_own, skills.view_own, timesheets.view_own, roster.view_own). These are granted to every default role, and the endpoints resolve the employee from the JWT — so a user can only ever reach their own records. The employment-agreement portal endpoints (see the Contracts note above) bypass the matrix entirely and authorize on the linked employee record.


Summary by role​

The six default roles are seeded per workspace with these grant counts (out of 148 total permissions). Super Admin holds all of them.

RoleDefault permissions
Super Admin148
HR Manager127
Accountant64
HR Officer76
Department Head51
Employee35
info

This matrix reflects the default grants at workspace creation. The six default roles cannot be changed; admins with roles.manage shape access with custom roles instead, and a person must sign in again to pick up a changed grant. See Custom roles and Default roles for more.