Articles in this section

User Admin - Bulk Import and Enhanced Bulk Import

User Admin in JustLogin includes two ways to add or update employee records in bulk β€” Bulk Import and Enhanced Bulk Import. Instead of entering each employee's details one at a time, you upload a prepared file to create or update multiple records at once. This article explains how each option works, how to complete the upload, and what each column in the Enhanced Bulk Import template means.

Understanding Your Options

Bulk Import

Upload employee information section by section using separate templates. Available sections depend on your subscribed modules.

Enhanced Bulk Import

Upload employee information across multiple modules using one Excel file with color-coded sections and a guidance row.

Note: The Enhanced Bulk Import tab is available only to eligible companies in Singapore, Malaysia, Hong Kong, and Myanmar. If your company is registered in another country, this tab may not appear in your account.

Both options share the following:

  • Minimum required fields: When creating a new employee record, you must complete at least: Username, Full Name, Email Address, and Join Date.
  • Error reporting: If the system finds errors in your file, you can download an Excel error file, correct your original file, and upload it again.

Prerequisites and Requirements

Before starting a bulk import, confirm you meet all of the following:

  • Super Admin access: Only the Super Admin can access User Admin and perform bulk imports.
  • Sufficient user licences: Your company must have enough licenses for the employees you are adding. The system will not let you exceed your available licences.

How to Access the Bulk Import Page

  1. Log in to JustLogin using your Super Admin account.
  2. On the left panel, click the dropdown arrow beside your profile or name.
  3. Select User Admin.
  4. Locate the Bulk Import and Enhanced Bulk Import tabs.
  5. Select the option you want to use.

How to Use Bulk Import

Bulk Import requires you to complete and upload each section separately.

Step 1: Download the Template

Select the module you want to update. 

  • Download Blank Template: Use this to create new employee records.
  • Download Existing Records: Use this to update existing employee information.

Step 2: Complete the CSV File

Open the downloaded file and enter the required information under the appropriate column headings.

Step 3: Upload the File

  1. Return to the relevant Bulk Import section.
  2. Drag and drop your completed CSV file into the upload area, or browse to select it from your computer.
  3. Click Import.
  4. Review the confirmation page and check that the displayed columns are correct.
  5. You will see a window asking "Are you sure you want to submit import details now?" Click YES.

Step 4: Check the Upload Result

  • Successful upload: A green "Well done" message confirms the upload was successful.
  • Upload errors: If errors occur, download the Excel error file, correct your original CSV file, and upload it again.

Repeat the upload process for each section that requires updating.

How to Use Enhanced Bulk Import

Enhanced Bulk Import lets you manage employee information for multiple modules in one Excel file.

Step 1: Download the Template

Go to the Enhanced Bulk Import tab and choose one of the following:

  • Download Blank Template: Use this to create new employee records.
  • Download Existing Records: Use this to update existing employee information.

Step 2: Understand the Colour-Coded Sections

The template uses different colours to identify each module's section.

A guidance row is also included to explain what each column in line number 2.

Step 3: Complete the Excel File

Enter the employee information in the relevant sections. You do not need to complete every section if it does not apply to your company or the employees you are managing. However, make sure all required fields are completed and follow the instructions in the template. Refer to the Understanding the Enhanced Bulk Import Columns section below for field-level guidance.

Step 4: Upload and Confirm the File

  1. Drag and drop the completed Excel file into the upload area, or browse to select it from your computer.
  2. Click Import.
  3. You will see a window asking "Are you sure you want to submit import details now?" Click YES.

     

Important: Do not add, remove, rename, or rearrange any columns from the original downloaded template. Changes to the column structure may cause the import to fail.

Step 5: Check the Upload Result

  • Successful upload: A green "Done" message confirms the upload completed successfully.
  • Upload errors: If errors occur, download the error file, review the flagged records or fields, correct your original Excel file, and upload it again.

Repeat these steps until the upload is successful.

Understanding the Enhanced Bulk Import Columns

The sections below explain the columns you may see in the Enhanced Bulk Import template. The exact fields available depend on your company's subscribed modules and country settings. Always refer to the downloaded template as the definitive reference for your account.

Basic Details

ColumnExplanation
UsernameThe employee's unique login name for the JustLogin website and mobile app. Avoid spaces and unsupported special characters.
Full NameThe employee's full name.
Email AddressA valid, active work or personal email address.
PasswordThe employee's initial login password. The default requirement is at least eight characters, including an uppercase letter, a lowercase letter, a number, and a symbol. Advise employees to change this at their first login.
Join DateThe employee's employment start date. Use DD/MM/YYYY.
Date of BirthThe employee's date of birth. Use DD/MM/YYYY.
Module User ColumnsIndicate whether the employee uses the relevant module. Enter Y if applicable or N if not. These fields do not grant administrative privileges.
Employee IDThe employee's staff or identification number, if used by your company.
DepartmentThe employee's department. Depending on your system's configuration, a department entered during upload may be created automatically if it does not already exist.
Designation NameThe employee's job title or position, such as Manager or HR Associate.
Designation CodeThe code assigned to the designation. Use a consistent naming convention.
SupervisorEnter the supervisor's username, not their full name. The username must match an existing record in the system.
Confirmation DateThe date the employee is confirmed after their probation period, where applicable.
Cessation DateThe employee's employment end date, typically for employees who have resigned or left the company.
GenderEnter a value accepted by the template.
Marital StatusEnter the marital status using the options or format specified in the template.

Leave Details

ColumnExplanation
EntitlementThe employee's full annual leave entitlement for the relevant leave year. Enter the full entitlement even if the employee has already used some leave during the year.
As At DateThe date from which the entitlement or balance applies. This is typically the start of the leave year, or the employee's join date for mid-year starters, depending on your configuration.
Opening BalanceLeave carried forward from the previous year, if permitted by your leave policy. For example, 14 days' entitlement plus 6 days' opening balance gives a total of 20 days before deductions.
Leave GradeEnter the exact name of the leave grade assigned to the employee, as it is configured in the system.
LBFLeave blank unless the template instructions specify otherwise.
LBFFFLeave blank unless the template instructions specify otherwise.
Work WeekEnter the exact name of the configured work week as it appears in your account β€” for example, Normal.
Working on PHEnter Y if the employee works on public holidays, or N if they do not.

Leave entitlement, opening balance, and carry-forward treatment depend on your company's leave policy and system configuration. Confirm the relevant settings before uploading.

Childcare Leave Details (Singapore accounts only)
The following fields apply to eligible Singapore accounts and employees, subject to the relevant childcare leave rules.

ColumnExplanation
Child NameEnter the child's name.
Child's Date of BirthEnter the child's date of birth using the required date format.
Leave Start YearEnter the year the employee starts using childcare leave, according to the employee's eligibility and the applicable rules.
Is the Child Singaporean?Enter Y if the child is a Singapore citizen or N if not. This helps determine the applicable childcare leave category, subject to eligibility requirements.

Payroll Details β€” Singapore

Payroll columns differ by country. Always refer to the downloaded template for the fields available to your account.

ColumnExplanation
NRIC or FINThe employee's Singapore identification number or Foreign Identification Number, as applicable.
RaceEnter the employee's race using the available options.
ReligionEnter the employee's religion if required by the template or your company's setup.
ResidencySelect the applicable status β€” for example, Citizen, PR, or Foreigner. This can affect statutory contribution calculations.
PR Start DateFor a Singapore Permanent Resident, enter the applicable PR start date if required.
PR End DateFor a Singapore Permanent Resident, enter the applicable PR end date if required.
Basic PayEnter the employee's basic salary, excluding allowances and other additional payments.
Pay SchemeSelect the applicable pay frequency β€” for example, Monthly or Fortnightly.
Pay ModeSelect the payment method β€” for example, bank transfer, cheque, or cash.
Payslip PINEnter the initial PIN used to protect payslip access. Follow your company's security practices and the system's requirements.
Bank CodeEnter the correct bank code. For Singapore banks, this is generally a four-digit code β€” verify it against the bank details and template instructions.
Account NumberEnter the employee's bank account number. Follow the template's formatting requirements and avoid unnecessary spaces or separators.
NationalityEnter the employee's nationality if required.
CountryEnter the applicable country information.
Postal CodeEnter the employee's postal code.
Address 1Enter the first line of the employee's address.
Address 2Enter the second line of the address, if applicable.
CPF Submission Number β€” Mandatory ContributionEnter the relevant CPF submission number for mandatory contributions, if required by the template.
CPF Submission Number β€” Voluntary ContributionEnter the relevant CPF submission number for voluntary contributions, if required by the template.

Payroll Details β€” Malaysia

Malaysia payroll fields differ from Singapore payroll fields because statutory contribution and tax requirements vary between countries.

ColumnExplanation
Tax ResidencySelect the applicable tax residency option available in the template.
Tax CategorySelect the applicable category β€” options may include Normal, Returning Expert Programme, or Knowledge Worker, depending on the template and the employee's circumstances.
TIN NumberEnter the employee's Tax Identification Number, where applicable.
PCB Borne by EmployerSelect Yes if the employer pays the employee's PCB on their behalf, or No if the employee bears it.
Employee DisabilityIndicate whether the employee has a disability, using the options provided.
Spouse DisabilityIndicate whether the employee's spouse has a disability, if applicable.
Tax Marital StatusSelect the applicable marital status. Options may distinguish between single employees with or without children and married employees with working or non-working spouses.
SOCSO CategorySelect the applicable SOCSO category from the available options.
Employee EPF RateEnter the employee's EPF contribution rate (for example, 11). Confirm the employee's eligibility and contribution arrangement before entering a rate.
Employee EPF Additional RateEnter an additional employee EPF contribution rate if applicable; otherwise follow the template's instructions.
Employer EPF Additional RateEnter an additional employer EPF contribution rate if applicable.
EPF NumberEnter the employee's EPF registration number.
SSFW NumberEnter the Social Security for Foreign Workers number, where applicable.
EPF Registered Before 1998Indicate Yes or No according to the employee's EPF registration history and the template's instructions.

Payroll fields also differ for Hong Kong and Myanmar. Always use the country-specific template provided by the system and verify all statutory information before uploading.

Attendance Details

ColumnExplanation
Employee TypeEnter 1 for Executive or 0 for Non-Executive.
Allow EditEnter Y if the employee can edit their own attendance records via the website, or N if they cannot.
Public Holiday PolicyEnter Y, N, or O β€” see the options table below.
PINEnter a four- or five-digit PIN for employees who use the JustLogin Kiosk. This may not be required for employees who record attendance via their own device or the website.
OT FormulaEnter the applicable overtime formula value β€” see the options table below.
Weekly HoursEnter the minimum weekly working hours before overtime is calculated. Applies only when OT Formula 3 is selected.

Public Holiday Policy options:

ValueBehaviour
YThe public holiday is treated as a normal working day, subject to your attendance and payroll configuration.
NThe public holiday is a non-working day. If the employee works, payment arrangements depend on your configuration and applicable rules.
OThe public holiday is a non-working day. If the employee works, time off in lieu may apply instead of additional payment, subject to your configuration.

OT Formula options:

ValueFormulaHow it works
0No OvertimeOvertime is not calculated using an overtime formula.
1End TimeOvertime is calculated based on the configured end-time method.
2Standard TimeThe calculation considers standard working hours and break time.
3Weekly OvertimeOvertime is calculated based on a weekly working-hours threshold. Enter the required threshold in the Weekly Hours field.

Expense Details

ColumnExplanation
Expense RoleSelect the appropriate role for the employee β€” see the role options below.
Expense Approving OfficersEnter the approving officers if required. You can leave this blank and assign approving officers in the system after uploading, where supported.
Expense Forwarding OfficersEnter the forwarding officers if required. You can leave this blank and assign forwarding officers in the system after uploading, where supported.

Expense Role options:

RoleWhat the employee can do
SubmitterCan submit their own expense claims. Does not provide approval or administrative privileges.
ApproverCan submit their own claims and approve assigned claims, subject to the configured approval workflow.
Expense AdminHas administrative access to the Expense module, including configuration, claims, reports, approvals, and reimbursements, subject to system permissions.
Super AdminHas broad system access, subject to the account's permissions and system controls.

Pre-Upload Checklist

Before uploading your file, run through the following checklist:

  • You are logged in as the Super Admin.
  • Your company has enough user licences for the employees you want to add.
  • You are using the correct file format: CSV for Bulk Import, XLSX for Enhanced Bulk Import.
  • All mandatory fields are completed.
  • Every username is unique, including usernames that previously belonged to deactivated users.
  • Dates are entered in DD/MM/YYYY format (unless your template specifies otherwise).
  • Country-specific payroll values are correct for your account's location.
  • The original template's column headings and structure are unchanged.
  • You have reviewed the confirmation page before clicking Submit.
  • After submission, you have checked the result message and resolved any errors before re-uploading.
Was this article helpful?
0 out of 0 found this helpful