This article guides Payroll Administrators on how to generate employees' tax forms and export files, and how to submit them directly to IRAS through JustLogin.
Pre-requisite: To use the Direct Submission feature, your company must be registered under the Auto-Inclusion Scheme (AIS). Learn how to join the AIS on the IRAS website. |
Overview
The IRAS submission process in JustLogin consists of three stages, which you can navigate between at any time:
- Generate IRAS Forms – Configure submission details and select employees.
- Review & Submit Forms – Review generated files, release them to employees, and submit to IRAS.
- Submission Status – View submission results and reference numbers.
Getting Started
- Step 1: Log in to JustLogin as a Payroll Administrator.
-
Step 2: Navigate to the Payroll module:
-
Step 3: From the main menu, select the IRAS section:
-
Step 4: You will see the three submission stages. You can click on any stage at any time:
Stage 1: Generate IRAS Forms
Step 5: Fill in the required details across the following sections.
IRAS Submission Details
| Field | Description |
|---|---|
| Tax Year | The tax submission year. |
| Payment Type | Greyed out and automatically set based on your Form/Export Type selection. |
| Form/Export Type |
IR8A Form, IRAS Export, Appendix 8A, and Appendix 8B will generate a PDF file. For reference: Tax Forms for Employers. |
| Organisation ID Type | The organisation type your company is registered under. For reference: UEN Information. |
| Source Type | Set to Private Sector by default. |
| Organization ID No. |
The system automatically captures the UEN saved under Company Details in Configuration. |
Other Details
| Field | Description |
|---|---|
| Batch Indicator |
|
| Batch Date | The date the file is generated. Defaults to today's date. |
| Division/Branch Name | Optional — complete only if applicable. |
| Appendix 8A/8B Options | Retrieves values from Appendix 8A and/or 8B when applicable. Note: The Appendix form(s) must be filled out before generating. See Appendix 8A and 8B guide. |
| Exclude Excess CPF Options | If "Auto exclude Employer Excess CPF" is checked, the Employer's Contribution amount in Section B of the IR8S form will be subtracted from the amount in Item 7 of the IR8A form. |
Authorised Person Details
IRAS will use the contact details in this section if they need to reach the company regarding the submission.
| Field | Description |
|---|---|
| Employee Name | The company's main person-in-charge (PIC). |
| Email Address | The PIC's email address. |
| Designation | The PIC's role/job title. |
| Company Name | The name of the company you are submitting tax forms for. |
| Phone Number | The PIC's contact number. |
Select Employees
Step 6: Select the employees whose IRAS files you are generating.
Tick "Exclude Employee with '0' income" to omit employees with zero income who are not required to be reported to IRAS.
Use the filter on the upper right to refine the employee list:
- Activated Employees – Active Payroll users.
- Deactivated Employees – Inactive or resigned employees who were Payroll users at the time of profile deactivation.
Adjust the number of entries displayed using the entries-per-page control:
Tick the checkbox beside "Employee" in the header row to select all employees in the current search results, or manually select individual employees.
Step 7: Click the button to proceed.
Stage 2: Review & Submit Forms
The system will direct you to this stage, where you can review the generated file(s) and submit them to IRAS.
| Column | Description |
|---|---|
| Form Type | The type of IRAS form or file generated. |
| Tax Year | The tax submission year. |
| Batch Date | The date when the file was generated. |
| Batch Indicator | Whether the submission is an original (first time) or an amendment. |
| Status | The current status of the generated file. |
| Total Users | The number of employees selected for the generated file. |
| Success | The number of records successfully generated. |
| Fail | The number of records that failed to generate. |
| Released | The number of files released to employees. |
| Run By | The Payroll Administrator who initiated the file generation. |
| Action | Options to Download, Release Files, or Delete the generated file. |
Action Icons
Depending on the type of file generated, the following action icons are available:
| Icon | Action |
|---|---|
| Download the generated file. | |
|
Release the PDF file to the employee. Once released, employees can view it under Payroll > My Payslip > Tax Documents. You can also check "Send IRAS form via email after release" to automatically email the form to the employee. Click |
|
| Delete the generated file — use this for failed files or if you wish to regenerate. |
Note: If any records failed to generate, make the necessary corrections and generate a new file. Repeat until all records are successfully generated. |
Reviewing Form Files
Click on the Form Type name to access the file details. A Tax File Download panel will load below.
Click on the file name to open the Tax File Download Preview page.
📌 Note: XML file formats are no longer supported. |
Once you have verified all information is correct, click to return to the Review & Submit Forms page. You may proceed with the submission immediately or return to it later.
Submitting to IRAS
Step 8: When you are ready to submit, select the file(s) and click the appropriate button at the lower right of the page:
-
— Use this if you are submitting your own company's tax information.
-
— Use this if you are a Tax Agent submitting on behalf of a client.
A confirmation pop-up will appear. Click Confirm to proceed, or Cancel to go back.
Step 9: A pop-up page will appear prompting you to log in with your SingPass credentials.
Note: If the pop-up does not appear, check your browser's pop-up blocker settings and allow pop-ups from JustLogin. |
Step 10: Once logged in, select the Company Tax Number you are submitting the tax file for.
Note (Tax Agents): If submitting as a Tax Agent, ensure you have been granted the appropriate authorisation before proceeding. See the IRAS Authorisation Guide. |
Step 11: Review and confirm the permission request, which authorises JustLogin to connect to IRAS and submit your tax records on your behalf.
Note: The page may take a moment to load after clicking Allow. Please wait until the pop-up window closes — this indicates that all data has been successfully uploaded. |
After submission is complete, you will be automatically redirected to the Submission Status page in JustLogin.
Stage 3: Submission Status
Step 12: If the submission was successful, a Submission Reference Number will be displayed. IRAS will also send an acknowledgement email confirming the submission status.
If the submission failed, use the status icons below to understand the issue:
| Icon | Meaning |
|---|---|
| Error — Incorrect or missing information must be corrected before generating and resubmitting a new file. | |
| Warning — You may either click |
Other IRAS Forms
Additional IRAS-related forms are accessible from the top of the IRAS page. Clicking any of these links will navigate you to the corresponding section in your account.
| Form | Purpose |
|---|---|
| IRAS Opening Balance | Record income for months prior to using JustLogin Payroll, or to correct missing pay elements and tax codes. |
| IRAS Employee Details | Capture additional employee information required for submission that is not recorded through the payrun. |
| Appendix 8A/8B | Separate forms to declare Benefits-in-Kind (BIK) and stock options. |
| IRAS Amendment | Used to correct any inaccurate data that has already been submitted to IRAS. |
| IR21 | Required for foreign employees who are leaving Singapore. |
| IR8S | Required if you have over-contributed CPF on an employee's wages and have requested (or plan to request) a refund of the excess contributions. |