Guide · tax year 2025 rules

1099-NEC CSV for IRIS: every column and what breaks a row

The IRS is moving information returns off its old FIRE system. Its IRIS Taxpayer Portal takes a CSV upload, and the CSV has strict rules. Here is the 1099-NEC layout, column by column, with examples of rows that break the rules.

What's changing

An August 2025 IRS working-group presentation says tax year 2026, filing season 2027, is the targeted date to retire FIRE, and that FIRE will not be available for submissions in filing season 2027. IRS presentation (PDF)

To use the IRIS Taxpayer Portal you need an IRIS Transmitter Control Code (TCC). The IRS says this code can only be used for IRIS. IRS IRIS page

Where these rules come from

Everything below is from the IRS's 1099-NEC Template Formatting Guidelines for tax year 2025, updated 14 January 2026. IRS guidelines (ZIP)

The IRS IRIS page didn't list tax year 2026 guidelines when this was written on 7 November 2026. Check the IRS file before you rely on a rule, and look on the portal for the current number of rows per upload. This is not tax advice, and Avyth isn't affiliated with the IRS.

Examples of rows that break the rules

  • A city with a period

    Cities allow letters and spaces only, so "St. Louis" fails. Write "St Louis" or "Saint Louis".

  • An address with # or a period

    Address lines allow only letters, numbers, spaces, hyphens and slashes. "Apt. #4" fails; "Apt 4" works.

  • A ZIP with a dash

    ZIP codes are digits only: 5, 9 or 12 of them. Write 123091234, not 12309-1234.

  • A dollar sign, comma or minus in an amount

    Amounts can't be negative, and allow digits and one decimal point only, with at most two digits after it.

  • An amount shown as 1.045E+5

    The IRS tells you to check amount columns for long numbers written in scientific notation, like this one.

  • A TIN without dashes

    EINs need XX-XXXXXXX and SSNs need XXX-XX-XXXX. The one exception is an undeterminable TIN (UND), which is 9 digits with no dashes.

  • A name that's too long or has stray spaces

    Business names stop at 40 characters and personal names at 20. Leading, trailing and double spaces all fail.

  • Neither box 1 nor box 2

    The IRS requires box 1 to be filled in or box 2 to be checked (Y).

Every column

Columns in the order the template uses. “Yes” means the IRS marks the field required.

ColumnFieldRequiredRule
AForm TypeExample in the IRS guide: 1099-NEC
BTax YearExample in the IRS guide: 2025
CPayer TIN TypeYesSSN or EIN
DPayer Taxpayer ID NumberYesDigits and dashes only. EIN as XX-XXXXXXX, SSN as XXX-XX-XXXX.
EPayer Name TypeYesB for a business name, I for an individual
FPayer Business or Entity Name Line 1If name type is BUp to 40 characters. Letters, numbers, spaces and - # ( ) & ' only. No leading, trailing or double spaces.
GPayer Business or Entity Name Line 2Up to 40 characters. Letters, numbers, spaces and - # ( ) & ' / % only. No leading, trailing or double spaces.
HPayer First NameIf name type is I, or a last name is givenUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
IPayer Middle NameUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
JPayer Last NameIf name type is I, or a first name is givenUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
KPayer SuffixUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
LPayer CountryYesThe IRS country abbreviation, such as US
MPayer Address Line 1YesUp to 35 characters. Letters, numbers, spaces, hyphens and slashes only. No leading, trailing or double spaces.
NPayer Address Line 2Up to 35 characters. Letters, numbers, spaces, hyphens and slashes only. No leading, trailing or double spaces.
OPayer City/TownYesUp to 40 characters. Letters and spaces only. No leading, trailing or double spaces.
PPayer State/Province/TerritoryYesUS: the 2-letter abbreviation. Foreign: up to 17 characters, A-Z, 0-9 and spaces only, with no leading, trailing or double spaces.
QPayer ZIP/Postal CodeYesUS: digits only, exactly 5, 9 or 12 of them. Foreign: up to 9 characters, A-Z and 0-9 only.
RPayer Phone TypeD for domestic, I for international
SPayer PhoneDomestic: 1231231234, 123-123-1234 or (123) 123-1234. International: up to 15 digits, with + allowed only at the start.
TRecipient TIN TypeIf a recipient TIN is givenSSN, EIN, ATIN, ITIN, QI-EIN or UND
URecipient Taxpayer ID NumberEIN and QI-EIN as XX-XXXXXXX. SSN, ITIN and ATIN as XXX-XX-XXXX. UND as 9 digits with no dashes.
VRecipient Name TypeYesB for a business name, I for an individual
WRecipient Business or Entity Name Line 1If name type is BUp to 40 characters. Letters, numbers, spaces and - # ( ) & ' only. No leading, trailing or double spaces.
XRecipient Business or Entity Name Line 2Up to 40 characters. Letters, numbers, spaces and - # ( ) & ' / % only. No leading, trailing or double spaces.
YRecipient First NameIf name type is I, or a last name is givenUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
ZRecipient Middle NameUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
AARecipient Last NameIf name type is I, or a first name is givenUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
ABRecipient SuffixUp to 20 characters. Letters, spaces and hyphens only. No leading, trailing or double spaces.
ACRecipient CountryYesThe IRS country abbreviation, such as US
ADRecipient Address Line 1YesUp to 35 characters. Letters, numbers, spaces, hyphens and slashes only. No leading, trailing or double spaces.
AERecipient Address Line 2Up to 35 characters. Letters, numbers, spaces, hyphens and slashes only. No leading, trailing or double spaces.
AFRecipient City/TownYesUp to 40 characters. Letters and spaces only. No leading, trailing or double spaces.
AGRecipient State/Province/TerritoryYesUS: the 2-letter abbreviation. Foreign: up to 17 characters, A-Z, 0-9 and spaces only, with no leading, trailing or double spaces.
AHRecipient ZIP/Postal CodeYesUS: digits only, exactly 5, 9 or 12 of them. Foreign: up to 9 characters, A-Z and 0-9 only.
AIOffice CodeExactly 4 digits
AJForm Account NumberUp to 20 characters, and not the same as the payer's or recipient's TIN
AK2nd TIN NoticeY for checked, N for unchecked
ALBox 1 - Nonemployee compensationUnless box 2 is YShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
AMBox 2 - Payer made direct sales totaling $5,000 or more of consumer products to a recipient for resaleY if box 1 is emptyY for Yes, N for No. One character.
ANBox 3 - Excess golden parachute paymentsShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
AOBox 4 - Federal income tax withheldShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
APCombined Federal/State FilingEach must be a 2-letter abbreviation on the IRS list of states available for this. In quotes, separated by commas, such as "AL,CA,DE". No duplicates. Not case sensitive, any order, and spaces are removed.
AQState 1If any State 1 field is filledThe state, territory, province or military equivalent, which should be its 2-letter abbreviation. If State 1 is given, at least one State 1 amount is needed.
ARState 1 - State tax withheldShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
ASState 1 - State/Payer state numberShould be at most 24 characters. Letters and numbers only, with no spaces or special characters.
ATState 1 - State incomeShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
AUState 1 - Local income tax withheldShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
AVState 1 - Special data entriesUp to 60 characters. Should only include letters, numbers and these special characters: !"#$%&'()*+,-./:;<>=?@{|}~£§ÁÉÍÑÓ×ÚÜáéíñóúü. No leading or trailing spaces, and never more than one space in a row.
AWState 2If any State 2 field is filledThe state, territory, province or military equivalent, which should be its 2-letter abbreviation. If State 2 is given, at least one State 2 amount is needed.
AXState 2 - State tax withheldShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
AYState 2 - State/Payer state numberShould be at most 24 characters. Letters and numbers only, with no spaces or special characters.
AZState 2 - State incomeShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
BAState 2 - Local income tax withheldShould be between 0 and 999,999,999,999,999. Can't be negative. Digits and one decimal point only, with at most two digits after it.
BBState 2 - Special data entriesUp to 60 characters. Should only include letters, numbers and these special characters: !"#$%&'()*+,-./:;<>=?@{|}~£§ÁÉÍÑÓ×ÚÜáéíñóúü. No leading or trailing spaces, and never more than one space in a row.