People & HR

Managing Users

Add new employees, edit their details, and manage the full user lifecycle — offboarding, reactivation, deletion, roles, departments, and managers.

Managing Users

Administrators, executives, and department heads create and maintain user accounts. This page covers adding people, editing their details, and the lifecycle actions that take a user from onboarding through offboarding (or deletion).

Adding a user

Open Add User from the directory (visible to admin/exec only). The creation form is deliberately short — only the essentials are captured up front, and the rest is filled in later by editing the profile.

FieldRequiredNotes
First nameYes
Last nameYes
EmailYesBecomes the login and where the welcome email is sent
Job titleNo
DepartmentNoIncludes an inline quick-add to create a department on the fly
RoleNoEMPLOYEE, DEPARTMENT_HEAD, ADMINISTRATOR, or EXECUTIVE
Set later, not at creation. Date of birth, employment start date, and manager are not part of the Add User form. Add them afterward via the Edit user modal.

Who can create whom

Creator roleCan create
Department headEmployees (and within their scope)
AdministratorEmployees, department heads, administrators
ExecutiveAny role, including another executive

Only an EXECUTIVE can create another EXECUTIVE. User creation is also subject to your plan's user limit.

What a new user gets

When you create a user, the system automatically:

  • Sends a welcome / setup email with a token valid for 14 days.
  • Forces a password change on first login.
  • Marks the email as not yet verified.
  • Grants default leave balances — the org's default annual allowance plus 10 sick days.
  • Sets profile completeness to 60.
Onboarding is not auto-started. Creating a user does not kick off an onboarding workflow — start that separately if you use it. See Documents → Onboarding for related setup.
No bulk / CSV import. Users are created one at a time — there is no bulk or CSV user import. (CSV/Excel/PDF on the directory is export-only.)

Editing a user

Open a user and choose Edit. The Edit modal is organized into tabs:

TabWhat you edit
ProfileCore personal identity fields
ContactEmail, phone, address, etc.
EmploymentJob title, division, department, manager, work location, employment type, dates, employee ID, payroll ID, role, active flag
AllowanceLeave allowance
HolidaysPublic-holiday assignment
ScheduleWorking schedule

Setting role, department, and manager

  • Role and Department are on the Employment tab (Department also has the inline quick-add at creation time).
  • Manager (reportsTo) is set on the Employment tab and is admin/exec only. The manager drives the org chart and the person's Direct Reports list.
  • Division is a free-text field that sits above department.

User lifecycle actions

From a user's record, the following actions are available (to admin/exec):

ActionEffect
OffboardBegins offboarding for a departing employee
ReactivateRestores a previously offboarded / inactive user
Permanently deleteRemoves the user account entirely
Resend credentialsRe-sends the welcome / setup email
Reset 2FAClears the user's two-factor configuration so they can re-enroll
Reset welcomeRe-issues the first-login setup flow
Deactivate is not delete. Offboarding / setting a user inactive disables access but retains the record. Permanent deletion is a separate, irreversible action.

Troubleshooting & notes

  • I want to import a spreadsheet of employees. Not supported — add users one at a time. The directory's CSV/Excel/PDF is export-only.
  • A new user can't do everything yet. New users must set a password (forced on first login) and verify their email before some features become available.
  • The welcome link expired. The setup token is valid for 14 days — use Resend credentials / Reset welcome to issue a fresh one.
  • I can't assign the Executive role. Only an existing executive can create or assign another executive.
  • The manager dropdown is disabled for me. Editing the manager (reportsTo) is restricted to admins and executives.