New Hire Record Layout

Use the following file specifications when submitting New Hire Reporting information to us through MassTaxConnect.

Updated: April 9, 2026

• The Employer Record ("A") must precede the Employee Records ("B").
• One file may be submitted containing multiple employers.
• All text values should be left justified.
• A flat fixed width text file is required with a ".txt" extension.
  Example(in ".txt" format)
• New Hire text files up to 2MG can be uploaded. Files larger than 4MG must be split into smaller text files. All text files must adhere to the required record layout format.
• Required format for Record Layout:

Record Name: A (Employer Record)

Location	Field	Length	Description and Remarks
1	Record Identifier	1	Constant "A" Indicates Employer Record
2-10	Employer Identification Number	9	Same Number Used to File Withholding Tax
11-40	Employer Name	30	N/A
41-58	Employer Street	18	N/A
59-76	Employer City	18	N/A
77-78	Employer State	2	State Abbreviation
79-87	Employer Zip Code	9	Zip + 4
88-89	Reporting Period Year	2	Year Information YY
90-95	Total Number of New Employees	6	N/A
96	Filler/Spaces	1	Spaces

Record Name: B (Employee Record)

Location	Field	Length	Description and Remarks
1	Record Identifier	1	Constant "B" Indicates an Employee record
2-10	Social Security Number	9	N/A
11-40	Social Security Number	30	Last Name, First Name Middle Initial
41-58	Employee Street	18	N/A
59-76	Employee City	18	N/A
77-78	Employee State	2	State Abbreviation
79-87	Employee Zip Code	9	Zip + 4
88-93	Start Date	6	First Day of Hire MM/DD/YY
94-96	Filler/Space	3	Spaces

Error Codes

Visit the error and message code listing to learn how to resolve an error that might result from a New Hire Reporting information submission.