to select ↑↓ to navigate
Smooth HR

Smooth HR

Employee Onboarding

Employee Onboarding is the live record for each hire going through pre-boarding. It links a Job Applicant or Employee, applies an Employee Onboarding Template, tracks portal progress, and creates HR Project/Task work.

Help URL: smoothhiring.com/help/hrms/onboarding/employee-onboarding


Quick reference

Action How
Create onboarding Onboarding → Employee Onboarding → New
Send portal access Submit record, or Send Portal Access
Preview as employee Preview Portal
Mark HR tasks done Mark as Completed
Reopen portal Unlock for Employee
Create employee master Create → Employee (from accepted applicant)

Desk path: /app/employee-onboarding


Creating onboarding

  1. New Employee Onboarding.
  2. Select Job Applicant (accepted candidate) or Employee (internal transfer) — one is required.
  3. Pick Employee Onboarding Template — loads activities and document rows.
  4. Set Date of Joining and Onboarding Begins On.
  5. Verify Employee Name and Email (from applicant/employee).
  6. Save (draft), then Submit.

On submit

  • Creates Project + Tasks from template activities.
  • Sets boarding_status to Pending.
  • Creates or enables Onboarding User and emails portal link (/app/onboarding-portal).
  • Sets portal_access_sent_on.

Portal progress fields

Field Meaning
Onboarding Progress Overall % complete
Documents Completed Document checklist progress
Section Status JSON map of portal sections
Onboarding Completed Employee submitted portal
Field Values Saved portal form data

HR actions after submit

Button When to use
Send Portal Access Resend credentials / link
Sync From Template Template gained new docs/activities
Preview Portal QA employee view
Mark as Completed Close HR tasks and project
Unlock for Employee Allow edits after completion
Create → Employee Convert accepted applicant to Employee

E-sign documents

For document rows with a Signature Template:

  1. Employee opens Onboarding Portal.
  2. Clicks Sign document/sign/{token}.
  3. Signed PDF attaches to the row; progress updates.

Requires Employee linked with valid email before signing.


Completing onboarding

When the employee clicks Submit onboarding:

  • Mandatory sections and documents must be complete.
  • onboarding_completed is set.
  • Mapped fields copy to Employee.
  • HR Manager and onboarding owner are notified.

Troubleshooting

Issue Fix
Portal email not received Check spam; use Send Portal Access; verify email on applicant
Duplicate onboarding error Cancel/archive existing onboarding for same person
Cannot e-sign Link Employee with email first
Progress not 100% Check mandatory docs/sections and either/or groups


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
Last updated 1 week ago
Was this helpful?
Thanks!