The IRIS 1099-NEC CSV template, column by column

The IRIS Taxpayer Portal lets you upload 1099-NEC forms (nonemployee compensation paid to contractors) as a CSV file instead of typing them in one by one. Here are all 54 columns of the template in order, and how the amounts in a FIRE (Publication 1220) file map onto them.

Convert a FIRE file to the 1099-NEC template Free check and preview in your browser. Nothing is uploaded.

Where the template comes from

Sign in to the IRIS Taxpayer Portal, choose to upload a CSV with form data, and download the blank 1099-NEC template. IRIS checks the header row of your upload against that template, so keep the header exactly as it is: same columns, same order, same wording. The column names below are the ones in the IRS's published formatting guidelines for IRIS CSV files.

Use one file per form type and per payer, and keep each file to 100 forms or fewer.

Publication 1220 amount codes to 1099-NEC boxes

In a FIRE file, each payee (B) record holds up to 18 payment amounts, numbered 1–9 and A–J. Which box each one belongs to depends on the form, and the codes don't always line up with box numbers.

Pub 1220 amount codeIRIS 1099-NEC column
1Box 1 - Nonemployee Compensation
4Box 4 - Federal income tax withheld

Formatting that trips people up

All 54 columns, in order

#ColumnFrom a FIRE file
1Form Type
2Tax Year
3Payer TIN Type
4Payer Taxpayer ID Number
5Payer Name Type
6Payer Business or Entity Name Line 1
7Payer Business or Entity Name Line 2
8Payer First Name
9Payer Middle Name
10Payer Last Name (Surname)
11Payer Suffix
12Payer Country
13Payer Address Line 1
14Payer Address Line 2
15Payer City/Town
16Payer State/Province/Territory
17Payer ZIP/Postal Code
18Payer Phone Type
19Payer Phone
20Recipient TIN Type
21Recipient Taxpayer ID Number
22Recipient Name Type
23Recipient Business or Entity Name Line 1
24Recipient Business or Entity Name Line 2
25Recipient First Name
26Recipient Middle Name
27Recipient Last Name (Surname)
28Recipient Suffix
29Recipient Country
30Recipient Address Line 1
31Recipient Address Line 2
32Recipient City/Town
33Recipient State/Province/Territory
34Recipient ZIP/Postal Code
35Office Code
36Form Account Number
372nd TIN Notice
38Box 1 - Nonemployee CompensationAmount code 1
39Box 2 - Payer made direct sales totaling $5,000 or more of consumer products to a recipient for resale
40Box 3 - Excess golden parachute payments
41Box 4 - Federal income tax withheldAmount code 4
42Combined Federal/State Filing (CF/SF) Check all states that apply.
43State 1
44State 1 - State Tax Withheld
45State 1 - State/Payer state number
46State 1 - State income
47State 1 - Local income tax withheld
48State 1 - Special Data Entries
49State 2
50State 2 - State Tax Withheld
51State 2 - State/Payer state number
52State 2 - State income
53State 2 - Local income tax withheld
54State 2 - Special Data Entries

Doing it by hand, or not

For a handful of forms, typing them straight into the IRIS portal is quickest. For more, you can fill this template in a spreadsheet using the tables above. If your accounting software only exports a Publication 1220 file, my FIRE to IRIS converter does the mapping, name splitting and file splitting for you, in your browser, so the SSNs in the file are never uploaded.

This page describes file formats, not tax rules. Check what belongs on each form with the IRS instructions or your tax professional.

Convert a FIRE file to the 1099-NEC template Free check and preview in your browser. Nothing is uploaded.

Microsoft Publisher, Word and PowerPoint are trademarks of Microsoft; PageMaker and InDesign of Adobe; Canva and Affinity of Canva. I'm not affiliated with any of them.