Core HR & Organization Setup
The Core HR module is the foundation of your Ligo HRM workspace. Every other module - leaves, timesheets, attendance, expenses - depends on data configured here first.
Prerequisites
Before configuring Core HR, ensure you have system administrator access (SUPER_ADMIN or HR_ADMIN).
Who Uses This Module?
| Role | What They Do |
|---|---|
| SUPER_ADMIN | Creates locations, departments, designations; full access |
| HR_ADMIN | Onboards employees; manages lifecycle (confirm, promote, transfer) |
| Manager | Views org chart; no admin permissions |
| EMPLOYEE | Updates own contact info; views org chart and profile |
Admin Workflow
Step 1 - Create Locations
Locations are your office branches or remote hubs. Attendance geofencing, leave calendars, and shifts all reference them.
Navigate to: Settings → Organization → Locations → Add Location
| Field | Description | Example |
|---|---|---|
| Name | Office or hub name | Headquarters – Mumbai |
| Timezone | Local timezone (IANA format) | Asia/Kolkata |
| Latitude / Longitude | GPS coordinates for geofencing | 19.0760, 72.8777 |
| Geofence Radius (m) | Distance limit for clock-in eligibility | 150 meters |
Step 2 - Create Departments
Departments define your organizational divisions: Engineering, Finance, HR, Sales, etc.
Navigate to: Settings → Organization → Departments → Add Department
| Field | Description | Example |
|---|---|---|
| Name | Division name | Engineering |
| Code | Short unique identifier | ENG |
| Parent Department | For nested structures (optional) | Technology |
| Department Head | Link after employees are created | (set after step 4) |
Step 3 - Define Designations
Designations are job titles with grade levels used to structure roles and salary bands.
Navigate to: Settings → Organization → Designations → Add Designation
| Field | Description | Example |
|---|---|---|
| Title | Job title | Software Engineer |
| Job Code | Short code | SWE |
| Grade Level | Seniority level | L3 |
Step 4 - Onboard Employees
With your organizational structure in place, add your employee records.
Navigate to: Employees → Onboard Employee
Required fields:
| Field | Notes |
|---|---|
| Employee Code | Must be unique across your organisation (e.g. ENG001) |
| First Name & Last Name | |
| Official Email | Used for login and all system notifications |
| Date of Joining | Sets tenure calculation start date |
| Department | Must already exist (created in Step 2) |
| Designation | Must already exist (created in Step 3) |
| Location | Sets timezone, calendar, and geofencing rules |
| Role | EMPLOYEE for staff; HR_ADMIN for HR team members |
What happens automatically: A user account is created and an activation email is sent to the employee’s official email address.
Step 5 - Build Reporting Hierarchies
After employees are created, assign their reporting managers.
Navigate to: Employee Profile → Employment Tab → Assign Manager
- PRIMARY manager - routes leave approvals, expense approvals, and performance reviews
- SECONDARY manager - optional escalation path
View the full company tree under Org Chart in the sidebar.
Step 6 - Manage the Employee Lifecycle
Use these HR actions from any Employee Profile page:
| Action | When to use | Where |
|---|---|---|
| Confirm Probation | Move employee from PROBATION → PERMANENT | Employee Profile → Confirm Employment |
| Promote | Change designation or grade level | Employee Profile → Promote |
| Transfer | Move employee to a different location | Employee Profile → Transfer Location |
| View History | See all past changes with before/after values | Employee Profile → History Tab |
Employee Workflow
Update Your Contact Details
Navigate to: My Profile → Contact Details
You can edit:
- Personal phone number
- Emergency contact (name, relation, phone)
You cannot change your department, designation, location, or reporting manager - contact HR for those.
View the Org Chart
Navigate to: Org Chart (sidebar)
Interactive reporting tree showing who reports to whom across the company.
Troubleshooting
| Problem | Solution |
|---|---|
| Employee not receiving activation email | Check spam folder; verify the official email address is correct |
| Cannot assign a manager - employee missing from list | The manager must already be an active employee in the system |
| Geofence rejects punches despite being in office | Increase the geofence radius or verify the GPS coordinates on the location |
| Cannot delete a department | Reassign or offboard all employees in that department first |
| Confirm/Promote option greyed out | Your account needs HR_ADMIN or SUPER_ADMIN role |