Documents & HR Templates

Udyamo HRMS provides a centralized document management system for storing, organizing, and retrieving employee documents — from identity proofs and tax declarations to offer letters and experience certificates. Alongside document storage, the platform includes an HR template system that lets you create reusable templates for payroll reports, offer letters, experience letters, and other standard HR correspondence.

This chapter covers both features in detail.


What You Will Learn

  • How to navigate to the Documents section
  • How to upload employee documents with proper categorization
  • Supported file types and size limits
  • How to view, download, search, and filter documents
  • How to manage HR templates for payroll and correspondence
  • Template creation, editing, and usage
  • Document retention considerations

Prerequisites

Required: You must have an Administrator or HR Manager role to upload and manage organization-wide documents. Employees can upload their own documents through the self-service portal if enabled.


Document Management Overview

The Document model in Udyamo HRMS supports polymorphic document types — meaning documents can be associated with individual employees, departments, or the organization as a whole. Each document record stores the file, its category, a description, and metadata about who uploaded it and when.

Key Characteristics

FeatureDetails
Supported file formatsPDF, JPEG, PNG, GIF, Excel (.xlsx, .xls), CSV
Maximum file size5 MB per file
StorageCloud-based, encrypted at rest
Access controlRole-based — admins see all documents; employees see only their own
Polymorphic associationDocuments can belong to an employee, a department, or the organization

Organization-Wide Documents

  1. Click Settings in the left sidebar.
  2. Select Documents (or navigate to Settings > HR > Documents).
  3. The Documents page displays all uploaded documents with filters.

Employee-Specific Documents

  1. Click Employees in the left sidebar.
  2. Click on the employee's name to open their profile.
  3. Click the Documents tab.
  4. The tab shows all documents associated with that employee.

Documents navigation


Uploading Employee Documents

Step-by-Step: Upload a Document

  1. Navigate to the employee's profile by clicking Employees > [Employee Name].
  2. Click the Documents tab.
  3. Click Upload Document (or the + button).
  4. Fill in the upload form:
FieldDescriptionRequired
Document TypeSelect the category of the document (see Document Categories below).Yes
FileClick Browse or drag and drop the file. Must be PDF, image (JPEG/PNG/GIF), Excel, or CSV. Max 5 MB.Yes
DescriptionA brief description of the document contents (e.g., "PAN Card front side").No
Expiry DateIf the document has an expiration (e.g., driving license), enter the date.No
  1. Click Upload or Save.
  2. The document appears in the employee's document list.

Document upload form

Warning: Files exceeding 5 MB will be rejected. If you need to upload a large file, compress it or split it into multiple files before uploading.

Tip: Encourage employees to upload clear, legible scans or photos. Blurry or illegible documents may need to be re-uploaded, delaying verification.


Document Categories

Udyamo HRMS organizes documents into predefined categories. These categories help with searching, filtering, and compliance.

Identity & Personal Documents

CategoryExamples
PAN CardPAN card copy (front/back)
Aadhaar CardAadhaar card copy (masked as per UIDAI guidelines)
PassportPassport first and last page
Driving LicenseValid driving license copy
Voter IDElection commission voter ID card
PhotoPassport-size photograph

Employment Documents

CategoryExamples
Offer LetterSigned offer letter from the organization
Appointment LetterFormal appointment letter
Experience LetterExperience or relieving letters from previous employers
Resignation LetterEmployee's resignation letter
Relieving LetterLetter confirming release from the organization
Non-Disclosure AgreementSigned NDA or confidentiality agreement

Financial & Tax Documents

CategoryExamples
Bank StatementCancelled cheque or bank passbook first page
Form 16Annual TDS certificate issued by the employer
Tax DeclarationEmployee's investment declaration for tax planning
Salary Slip (Previous)Payslips from prior employment for CTC verification

Educational Documents

CategoryExamples
Degree CertificateUniversity degree or diploma certificate
MarksheetAcademic transcripts and marksheets
Professional CertificationIndustry certifications (e.g., PMP, AWS, CA)

Medical Documents

CategoryExamples
Medical CertificateFitness certificate or medical leave certificate
Insurance CardESIC card or private health insurance card

Tip: If you need a document category that is not listed, contact your administrator. Custom categories can be configured in Settings.


Viewing and Downloading Documents

Viewing a Document

  1. Navigate to the employee's Documents tab (or the organization Documents page).
  2. Locate the document in the list.
  3. Click the document name or the View icon.
  4. PDFs and images open in a preview pane within the browser.
  5. Excel and CSV files may prompt a download instead of a preview.

Downloading a Document

  1. Locate the document in the list.
  2. Click the Download icon (typically a down-arrow icon).
  3. The file downloads to your local device.

Tip: For bulk downloads, select multiple documents using the checkboxes and click Download Selected. The files will be downloaded as a ZIP archive.

Document list with view and download options


Searching and Filtering Documents

The Documents page provides search and filter capabilities to quickly locate specific files.

  • Use the Search bar to search by document name, employee name, or description.
  • The search is case-insensitive and supports partial matches.

Filters

FilterOptions
Document TypeSelect a specific category (e.g., PAN Card, Offer Letter)
EmployeeSearch by employee name or ID
DepartmentFilter by department
Upload DateFilter by date range
Expiry StatusShow documents nearing expiry or already expired

Tip: Use the Expiry Status filter regularly to identify documents like driving licenses, passports, or professional certifications that are about to expire. Proactively notify employees to upload renewed copies.


Employee Self-Service Document Upload

Employees can upload their own documents through the self-service portal, reducing the administrative burden on HR teams.

What Employees Can Do

  • Upload personal documents (PAN, Aadhaar, bank details, etc.)
  • View and download their own documents
  • View documents shared by the organization (policies, handbooks)

What Employees Cannot Do

  • View other employees' documents
  • Delete documents uploaded by HR or admin
  • Access organization-wide confidential documents

Step-by-Step: Employee Uploads a Document

  1. Log in to Udyamo HRMS.
  2. Navigate to My Profile > Documents.
  3. Click Upload Document.
  4. Select the Document Type, attach the file, and add a description.
  5. Click Upload.
  6. The document is saved and visible to the employee and their HR admin.

Warning: Remind employees to mask the first 8 digits of their Aadhaar number before uploading, in compliance with UIDAI guidelines. Udyamo HRMS stores documents securely, but masking is a regulatory best practice.


HR Templates

Udyamo HRMS includes a Template model that allows organizations to create reusable document templates for common HR correspondence and payroll outputs.

Template Types

Template TypePurposeCommon Use
Offer LetterTemplate for new employee offer lettersPre-fill with employee name, designation, CTC, joining date
Appointment LetterFormal appointment confirmationPre-fill with employment terms and conditions
Experience LetterLetter confirming employment tenure and rolePre-fill with name, designation, dates of employment
Relieving LetterLetter confirming release from the organizationPre-fill with last working day and settlement status
Payslip TemplateLayout and format for monthly payslipsDefine which salary components appear and their order
Salary CertificateCertificate confirming salary details for banks or visa applicationsPre-fill with current salary components
Bank Advice TemplateFormat for the monthly bank advice (salary transfer) fileDefine bank-specific columns and format
Custom TemplateAny other HR correspondenceUser-defined content with placeholders
  1. Click Settings in the left sidebar.
  2. Select HR Templates (or navigate to Settings > Templates).
  3. The Templates page lists all configured templates.

HR Templates list


Creating an HR Template

Step-by-Step: Create a New Template

  1. Navigate to Settings > HR Templates.
  2. Click Add Template (or Create New).
  3. Fill in the template form:
FieldDescriptionRequired
Template NameA descriptive name (e.g., "Standard Offer Letter").Yes
Template TypeSelect from Offer Letter, Experience Letter, Payslip, etc.Yes
ContentThe template body with placeholder variables. Use a rich text editor.Yes
DescriptionInternal notes about when to use this template.No
  1. Insert placeholder variables where dynamic data should appear.
  2. Click Save.

Placeholder Variables

Templates use placeholder variables that are replaced with actual data when the template is used to generate a document.

PlaceholderReplaced With
{{employee_name}}Employee's full name
{{employee_id}}Employee ID
{{designation}}Employee's current designation
{{department}}Employee's department
{{date_of_joining}}Date of joining
{{last_working_day}}Last working day (for exit letters)
{{annual_ctc}}Annual CTC in INR
{{basic_pay}}Monthly basic pay
{{gross_pay}}Monthly gross pay
{{organization_name}}Organization name
{{current_date}}Today's date
{{years_of_service}}Completed years of service

Example: Offer Letter Template

Date: {{current_date}}

Dear {{employee_name}},

We are pleased to offer you the position of {{designation}} in the
{{department}} department at {{organization_name}}.

Your annual compensation (CTC) will be INR {{annual_ctc}}.

Your date of joining is {{date_of_joining}}. Please report to our
office at 9:00 AM on your joining date.

This offer is contingent upon successful completion of background
verification and submission of all required documents.

We look forward to welcoming you to the team.

Regards,
HR Department
{{organization_name}}

Tip: Create multiple versions of the same template type if needed — for example, separate offer letter templates for different departments or seniority levels.


Editing and Deleting Templates

Editing a Template

  1. Navigate to Settings > HR Templates.
  2. Click the template name or the Edit icon.
  3. Modify the content, name, or type as needed.
  4. Click Save.

Warning: Editing a template does not retroactively change documents that were previously generated using that template. It only affects future document generation.

Deleting a Template

  1. Navigate to Settings > HR Templates.
  2. Click the Delete icon next to the template.
  3. Confirm the deletion.

Warning: Deleting a template is permanent. If you may need the template again, consider renaming it to "(Archived)" instead of deleting it.


Using Templates to Generate Documents

Step-by-Step: Generate a Document from a Template

  1. Navigate to the employee's profile.
  2. Click Documents or Generate Letter.
  3. Select the template you want to use (e.g., "Standard Offer Letter").
  4. The system populates the placeholder variables with the employee's actual data.
  5. Review the generated document. Make any manual edits if needed.
  6. Click Download as PDF or Save to Employee Documents.

The generated document is automatically saved in the employee's document record with the appropriate category.

Generate document from template


Document Retention Policies

Organizations should establish document retention policies that comply with Indian labor law and company policy.

Document TypeRecommended RetentionReason
Employment records8 years after separationLabour law compliance, potential disputes
Payroll records8 yearsIncome tax and PF audit requirements
Form 16 / TDS records8 yearsIncome tax assessment period
EPF / ESIC recordsUntil retirement or final settlementStatutory compliance
Offer / Appointment lettersDuration of employment + 5 yearsEmployment verification
Experience / Relieving lettersDuration of employment + 5 yearsReference checks
Medical records5 years after separationESIC and insurance requirements
Identity documentsDuration of employment + 3 yearsKYC compliance

Tip: Udyamo HRMS retains all documents for terminated employees as part of the historical record. Documents are not automatically deleted when an employee exits. Review your retention policy annually and archive or purge documents that exceed the retention period.


File Validation Rules

Udyamo HRMS enforces the following validation rules when uploading documents:

RuleConstraint
Allowed file typesPDF (.pdf), JPEG (.jpg, .jpeg), PNG (.png), GIF (.gif), Excel (.xlsx, .xls), CSV (.csv)
Maximum file size5 MB per file
File name charactersAlphanumeric, hyphens, underscores, and dots only. Special characters are stripped.
Duplicate handlingMultiple files of the same type can be uploaded for the same employee. Each upload creates a separate record.

Warning: Executable files (.exe, .bat, .sh), compressed archives (.zip, .rar), and other unsupported formats are rejected. If you need to upload a document in an unsupported format, convert it to PDF first.


Common Errors and Solutions

ProblemCauseSolution
"File type not supported"Uploaded a file in an unsupported formatConvert to PDF, JPEG, PNG, Excel, or CSV
"File size exceeds limit"File is larger than 5 MBCompress the file or reduce image resolution
Upload button is disabledUser does not have upload permissionsCheck the user's role; employees can only upload to their own profile
Template placeholders not replacedIncorrect placeholder syntaxVerify placeholders match the format {{variable_name}} exactly
Generated letter has missing dataEmployee profile fields are incompleteComplete the employee's profile before generating the letter

Best Practices

  1. Standardize naming conventions. Use consistent document names (e.g., "PAN_Card_EMP001.pdf") for easy searching.
  2. Verify documents at onboarding. Collect and upload all required identity and financial documents during the onboarding process.
  3. Use templates for consistency. Generate offer letters, experience letters, and other correspondence from templates rather than creating them from scratch each time.
  4. Review document expiry dates. Set up a monthly review of documents nearing expiry and notify employees to provide updated copies.
  5. Limit access appropriately. Ensure that sensitive documents (medical records, salary details) are only accessible to authorized personnel.

What Comes Next

With documents and templates covered, the next part of the guide addresses communication and reporting features. Proceed to Chapter 42: Announcements & Notifications.