The employee portal (admin view)
Every person with an employee record and a login gets the self-service portal
at /portal — their own attendance, leave, salary slips, documents, letters,
assets, and profile. What employees can do there is documented step-by-step in
the public User guide; point new joiners at it. This page
covers the admin side of the portal.
Connecting logins to employee records
The portal shows a person their own data by matching their login to an employee record. If someone opens the portal and sees "No employee profile linked", their login exists but is not attached to an employee: link the user to the employee from Access Control → Users and the portal comes alive for them.
The standard Employee role carries the "view own" permissions the portal runs on — a plain employee never sees the admin app, and portal pages only ever return the signed-in person's own rows.
What appears, and when
Several portal entries are conditional, so two employees can see different sidebars:
- Tax Certificates exists only where the workspace's country levies personal income tax; in a no-income-tax workspace the entry (and an otherwise-empty section) is removed entirely.
- Field Visits appears only for staff you have enrolled as field staff in Field visits.
- GPS Clock In/Out buttons appear on My Attendance only when the employee is assigned to an attendance site (Attendance).
- Team Expenses appears only for people whose role holds Approve Team Expense Claims (by default HR Manager and Department Head); it lists the claims their direct reports have submitted (Expense claims).
- Reviews appears only for people whose role holds Review Team Appraisals (by default HR Manager and Department Head), and My Appraisals only for roles with View Own Appraisals (Performance).
- Letters appears only for roles with View Own HR Letters (every default role except Accountant).
- My ID Card, My Email Signature and My Business Card appear only once the workspace has unlocked Brand Studio (no plan includes it), for roles with View Own ID Card, Business Card & Email Signature (every default role). Until then they are hidden, not shown locked (Brand Studio).
- Sales Report appears only for staff in a sales department.
- My Interviews matters only for interview-panel members (Recruitment).
Hiding an entry is not what keeps someone out: the API refuses the request when the role lacks the permission. A reporting manager on the Employee role who opens Reviews or Team Expenses by its address sees You don't have access to this page, with the permission the page needs and a pointer to their HR administrator, not an empty list. To let them in, add the permission to their role (Access control).
The portal as an app
The portal is installable: a bar under the top bar offers Install where
the browser allows it (Android, desktop Chrome and Edge) and the Share → Add to
Home Screen steps on iOS. The installed app opens at /portal and keeps the
last answers for My Schedule, My Salary, My Leaves and My Attendance so they
render without a network. Those answers are kept for the person and workspace
that fetched them, for up to seven days, and are removed at sign-out: on a
shared device the next person never sees them.
When a new version is released, the portal shows A new version is ready with a Reload button. Nothing changes under an employee who is part-way through a form until they press it; left alone, the new version takes over the next time the app is opened.
On the shared address the app's name and icon are the platform's. On your own domain (Email and domain) the installed app carries your workspace's app name, and your favicon as its icon when that is a square PNG or WebP image of at least 192 pixels; with a smaller or non-square favicon the platform's icon stays.
GPS clock-ins made with no signal can be saved on the device and sent when it is back online, recorded at the time pressed and marked Offline replay in Attendance Logs. This is off until you switch on Accept offline punches under Attendance Settings → Geo Attendance, because it trusts the phone's clock for when the punch was pressed; with it off, a punch with no network fails as any failed request does. A saved punch that waited more than two days, or is earlier than a punch already recorded for that day, is refused and logged as a rejected attempt (see Attendance). Push notifications to installed devices need the operator's VAPID keys (see the deployment guide); employees switch them on per device from the notifications page.
The queues the portal feeds
Employee self-service is the entry point of several admin workflows:
- Leave applications land in leave approvals (Leave).
- Expense claims go to the reporting manager, then HR/Finance (Expense claims).
- Loan requests wait for approval (Loans).
- Letter requests arrive for HR to approve and issue (Contracts & letters).
- Profile submissions — when an employee edits their own My Account profile and shares it, HR reviews the snapshot and approves or returns it; approval copies the details into the employee record and may re-trigger phone/address verification.
- Attendance regularizations and missed-punch fixes flow into attendance review (Attendance).
Acknowledgment evidence
The portal's confirm-receipt flows exist for your audit trail: contract acceptance and salary-slip acknowledgments are recorded with a timestamp (and IP address for slips), and acknowledged slips release the signed PDF to the employee (Payroll).
Badges
Badges & Achievements on the employee dashboard are a recognition feature only — earned automatically from milestones (perfect attendance months, service anniversaries, promotions) and never affecting pay, leave, or performance scores. They can be enabled or disabled per workspace. Monthly badges are judged on the 1st, once the month has ended in the workspace's time zone.