Employee Records
The Employee record is the central person record in Smooth HR. It links a human being to your Company, Department, Designation, payroll, leave, expenses, performance, and — when configured — a User for self-service portal access.
Help URL: https://smoothhiring.com/help/hrms/people/employee-records
Table of contents
- Overview
- Who uses Employee records
- Desk paths
- Creating an Employee
- From recruitment and onboarding
- Key fields and tabs
- Linking a User for portal access
- Status and lifecycle
- Common mistakes
- Troubleshooting
Overview
Every HR transaction — leave, attendance, expense claim, salary slip, appraisal — references an Employee name. The record stores employment details, reporting structure, contact information, and links to job history when created from Job Offer.
| Concept | Detail |
|---|---|
| Naming | Controlled by HR Settings Employee Naming By (Naming Series, Employee Number, or Full Name) |
| Company | Required; drives payroll, tax, and permissions |
| Department / Designation | Org placement; used in approvals and recruitment matching |
| Reports to | Builds organizational chart and approval chains |
| User ID | Links the login User for ESS and onboarding portal |
Smooth HR runs in the cloud. Module sidebars (People, Recruitment, Expenses, Performance, Tenure, NextAI) appear after login. Use the left sidebar or search (Ctrl+K / Cmd+K) to open lists and workspaces.
Who uses Employee records
| Role | Typical use |
|---|---|
| HR Manager | Full create/submit/cancel; setup masters; reports |
| HR User | Day-to-day transactions; may need approval rules |
| Employee | Self-service where enabled |
| System Manager | Site-wide configuration, integrations, NextAI keys |
| Role | Typical actions |
|---|---|
| HR Manager | Create, edit, deactivate employees; bulk import |
| HR User | Update contact info, department moves, manager changes |
| Employee | Read own record; limited self-service updates if enabled |
| Payroll | Verify bank, tax, salary structure assignment before pay run |
| System Manager | Fix broken User links; permissions |
Desk paths
| Action | Desk path |
|---|---|
| Employee list | /app/employee |
| Open employee | /app/employee/{employee-id} |
| People workspace | /desk/people |
| HR Settings | /app/hr-settings |
| Organizational chart | /app/organizational-chart |
Creating an Employee
Manual creation
- Open People → Employee → Add Employee.
- Set First Name, Company, Date of Joining, Department, Designation.
- Set Gender, Date of Birth if required by your policies.
- Set Reports to for org chart and leave/expense approvers.
- Save. Assign salary structure from Payroll when ready.
Naming series
If HR Settings uses Naming Series, the ID may look like HR-EMP-00042. If Full Name, the document name is the employee name — avoid duplicates.
From recruitment and onboarding
Typical hire flow:
flowchart LR
JobOpening --> JobApplicant
JobApplicant --> Interview
Interview --> JobOffer
JobOffer --> EmployeeOnboarding
JobOffer --> Employee
- Job Applicant is named by email (document name =
email_id). - Interview rounds track feedback per Interview Round master.
- Job Offer accepted → use Create Employee (Create Employee maps offer fields to Employee).
- Employee Onboarding may run in parallel with e-sign via Signature Templates.
After Create Employee from Job Offer, personal email and name copy from the applicant record.
Key fields and tabs
| Field / area | Purpose |
|---|---|
| Company | Legal employer |
| Department | Team; drives approvers |
| Designation | Job title; matches Job Opening |
| Branch | Location if used |
| Grade | Policy bands, onboarding templates |
| Employment Type | Full-time, part-time, contract |
| Reports to | Manager Employee link |
| User ID | Portal login |
| Job Applicant | Back-link when created from offer |
| Bank / Salary | Payroll tabs |
Linking a User for portal access
- Create User with employee's work email (or personal if that is login).
- Assign roles: Employee, plus module roles as needed.
- On Employee, set User ID to that user.
- Employee can access leave, expenses, goals per permissions.
Without User ID, the employee cannot use self-service or the onboarding portal tied to their email.
Status and lifecycle
| Status | Meaning |
|---|---|
| Active | Currently employed |
| Inactive | Left or on long leave without pay (per policy) |
| Suspended | Disciplinary hold (if used) |
Use Employee Separation for structured offboarding; it can create a separation project with tasks.
Common mistakes
| Mistake | Fix |
|---|---|
| No User linked | Set User ID after User creation |
| Wrong company on Employee | One primary company; use transfers properly |
| Duplicate email as Job Applicant name | Applicant name IS email — use unique emails |
| Skipping Reports to | Set manager for approvals and org chart |
| Creating Employee before masters | Create Company, Department, Designation first |
Troubleshooting
| Issue | What to do |
|---|---|
| Cannot save Employee | Check mandatory Company, DOJ, gender if required |
| Employee not in payroll | Assign Salary Structure Assignment |
| Portal login fails | Verify User ID, role Employee, password reset |
| Create Employee greyed on Job Offer | Offer must be submitted; applicant not already employee |
Bulk import and integrations
Use Data Import on Employee for CSV uploads. Include Company, Department, and Designation values that already exist. Import in batches and validate org chart after each batch.
API integrations should use stable Employee IDs from naming series rather than display names. External systems mapping by email should use the User email or personal/work email fields consistently.
When rehiring, decide policy: new Employee record with new joining date vs reactivating old record — payroll and tenure reporting differ.
Frequently asked questions
Can employees edit their own record?
Only if permissions allow; typically HR owns master data.
Where is job applicant link stored?
On Employee when created from Job Offer; field Job Applicant.
How do I deactivate without separation doc?
Set status Inactive — but Tenure separation is recommended for audit trail.
Related guides
Last updated: May 2026
Smooth LMS (training)
| Guide | Link |
|---|---|
| LMS help home | smoothhiring.com/help/lms |
| HRMS + LMS overview | lms/hrms-integration/overview |
| Auto-provision LMS access | lms/hrms-integration/employee-auto-provisioning |
| Onboarding mandatory training | lms/hrms-integration/onboarding-mandatory-training |
| Compliance vs certificates | lms/hrms-integration/compliance-vs-lms-certificates |
| Mandatory courses | lms/courses/mandatory-training-and-validity |
| Course categories (folders) | lms/courses/categories-and-tags |