TIN ComplianceA resource from TIN Comply
IRIS form rules

IRIS Form 1099-R: rules and XML elements

What IRIS checks on Form 1099-R, Distributions From Pensions, Annuities, Retirement Plans, IRAs, Insurance Contracts: the 5 business rules specific to this form for tax year 2026, with each rule's severity and what it checks, and the 30 elements of Form1099RDetail in the tax year 2026 XML record.

Submission group 1XML element Form1099RDetailElements 30, 11 required

The form, box by box: where each box goes in IRIS

Copy A of Form 1099-R, with the IRIS XML element written at every box and a number that matches the table below. The table adds whether the element is required, its format, the Pub 1220 (FIRE) position the box used to have, and the portal CSV template column it lands in.

IRS Form 1099-R with the IRIS XML element shown at each box, numbered to match the field mapBox 1: VOIDIRIS elementVoidIndRequiredRequired, 1 or 0Pub 1220 (FIRE)None: FIRE has no void recordCSV templateNo column in the TY2025 templateClick to open row 1 in the field mapBox 2: CORRECTEDIRIS elementCorrectedInd, with PrevSubmittedRecRecipientGrp when 1RequiredRequired, 1 or 0Pub 1220 (FIRE)B record 6CSV templateNo column in the TY2025 templateClick to open row 2 in the field mapBox 3: PAYER'S nameIRIS element (BusinessNameLine2Txt optional), or PersonName (PersonFirstNm, PersonMiddleNm, PersonLastNm, SuffixNm); name control optionalRequiredRequired in the headerPub 1220 (FIRE)A record 53-92 (second name line 93-132); name control 21-24CSV templatePayer Name Type
Payer Business or Entity Name Line 1
Payer Business or Entity Name Line 2
Payer First Name
Payer Middle Name
Payer Last Name (Surname)
Payer Suffix
Click to open row 3 in the field map
Box 4: 1 Gross distributionIRIS elementGrossDistributionAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 1, B record 55-66CSV templateBox 1 - Gross distributionClick to open row 4 in the field mapBox 5: Calendar year (printed)IRIS elementTaxYr (also  and the manifest)RequiredRequired, four-digit yearPub 1220 (FIRE)B record 2-5CSV templateTax YearClick to open row 5 in the field mapBox 6: Street addressIRIS elementRequiredRequiredPub 1220 (FIRE)A record 134-173CSV templatePayer Address Line 1Click to open row 6 in the field mapBox 7: Room or suite no.IRIS elementRequiredOptionalPub 1220 (FIRE)Within A record 134-173 (FIRE has one address line)CSV templatePayer Address Line 2Click to open row 7 in the field mapBox 8: 2a Taxable amountIRIS elementTaxableAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 2, B record 67-78CSV templateBox 2a - Taxable amountClick to open row 8 in the field mapBox 9: City or townIRIS elementRequiredRequiredPub 1220 (FIRE)A record 174-213CSV templatePayer City/TownClick to open row 9 in the field mapBox 10: Telephone numberIRIS elementRequiredOptionalPub 1220 (FIRE)A record 225-239CSV templatePayer Phone Type
Payer Phone
Click to open row 10 in the field map
Box 11: 2b Taxable amount notIRIS elementTxblAmountNotDeterminedIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 547CSV templateBox 2b - Taxable amount not determined
Box 2b - Total distribution
Click to open row 11 in the field map
Box 12: TotalIRIS elementTotalDistributionIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 549CSV templateBox 2b - Total distributionClick to open row 12 in the field mapBox 13: State or provinceIRIS element ()RequiredRequired for a U.S. addressPub 1220 (FIRE)A record 214-215CSV templatePayer State/Province/TerritoryClick to open row 13 in the field mapBox 14: CountryIRIS elementRequiredForeign address onlyPub 1220 (FIRE)A record 52 (foreign entity indicator); the address stays in 134-224CSV templatePayer CountryClick to open row 14 in the field mapBox 15: ZIP or foreign postal codeIRIS element ()RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)A record 216-224CSV templatePayer ZIP/Postal CodeClick to open row 15 in the field mapBox 16: 3 Capital gain (included inIRIS elementCapitalGainAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 3, B record 79-90CSV templateBox 3 - Capital gain (included in box 2a)Click to open row 16 in the field mapBox 17: 4 Federal income taxIRIS elementFederalIncomeTaxWithheldAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 4, B record 91-102CSV templateBox 4 - Federal income tax withheldClick to open row 17 in the field mapBox 18: PAYER'S TINIRIS element with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)RequiredRequired, 9 digitsPub 1220 (FIRE)A record 12-20CSV templatePayer TIN Type
Payer Taxpayer ID Number
Click to open row 18 in the field map
Box 19: RECIPIENT'S TINIRIS element with RequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateRecipient TIN Type
Recipient Taxpayer ID Number
Click to open row 19 in the field map
Box 20: 5 Employee contrib./IRIS elementEmployeeContributionsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 5, B record 103-114CSV templateBox 5 - Employee contributions/Designated Roth contributions or insurance premiumsClick to open row 20 in the field mapBox 21: 6 NUA in employer'sIRIS elementNetUnrlzdSecuritiesApprcnAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 6, B record 115-126CSV templateBox 6 - Net unrealized appreciation in employer's securitiesClick to open row 21 in the field mapBox 22: RECIPIENT'S nameIRIS element (PersonFirstNm, PersonMiddleNm, PersonLastNm, SuffixNm) or  and BusinessNameLine2Txt; name control optional; AdditionalRecipientTxt for a second payeeRequiredRequired (one of the two)Pub 1220 (FIRE)B record 288-367; name control 7-10CSV templateRecipient Name Type
Recipient Business or Entity Name Line 1
Recipient Business or Entity Name Line 2
Recipient First Name
Recipient Middle Name
Recipient Last Name (Surname)
Recipient Suffix
Click to open row 22 in the field map
Box 23: 7a Dist.IRIS elementForm1099RDistributionCdRequiredRequired, code from a list of 120Pub 1220 (FIRE)B record 545-546CSV templateBox 7 - Distribution code(s)Click to open row 23 in the field mapBox 24: 7b IRA/SEP/IRIS elementIRASEPSIMPLEIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 548CSV templateIRA/SEP/SIMPLEClick to open row 24 in the field mapBox 25: 7c TrumpIRIS elementTrumpAccountIndRequiredRequired, 1 or 0Pub 1220 (FIRE)None in Pub 1220 (IRIS only)CSV templateNew box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet.Click to open row 25 in the field mapBox 26: 7d Earnings onIRIS elementExcessContributionsEarningsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)None in Pub 1220 (IRIS only)CSV templateNew box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet.Click to open row 26 in the field mapBox 27: Street addressIRIS elementRequiredRequiredPub 1220 (FIRE)B record 368-407CSV templateRecipient Address Line 1Click to open row 27 in the field mapBox 28: Apt. no.IRIS elementRequiredOptionalPub 1220 (FIRE)Within B record 368-407 (FIRE has one address line)CSV templateRecipient Address Line 2Click to open row 28 in the field mapBox 29: City or townIRIS elementRequiredRequiredPub 1220 (FIRE)B record 448-487CSV templateRecipient City/TownClick to open row 29 in the field mapBox 30: 8a OtherIRIS elementOtherDistributionAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 8, B record 139-150CSV templateBox 8 - Other ($)Click to open row 30 in the field mapBox 31: 8b Percentage of annuityIRIS elementRcpntOthDistributionPctRequiredOptional, decimal 0 to 1Pub 1220 (FIRE)B record 550-551CSV templateBox 8 - Other (%)Click to open row 31 in the field mapBox 32: State or provinceIRIS element ()RequiredRequired for a U.S. addressPub 1220 (FIRE)B record 488-489CSV templateRecipient State/Province/TerritoryClick to open row 32 in the field mapBox 33: CountryIRIS elementRequiredForeign address onlyPub 1220 (FIRE)B record 287 (foreign country indicator); the address stays in 368-498CSV templateRecipient CountryClick to open row 33 in the field mapBox 34: ZIP or foreign postal codeIRIS element ()RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)B record 490-498CSV templateRecipient ZIP/Postal CodeClick to open row 34 in the field mapBox 35: 9a Percentage of total dist.IRIS elementRcpntTotalDistributionPctRequiredOptional, decimal 0 to 1Pub 1220 (FIRE)B record 550-551CSV templateBox 9a - Your percentage of total distributionClick to open row 35 in the field mapBox 36: 9b Total employee contrib.IRIS elementTotalEmployeeContributionsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 9, B record 151-162CSV templateBox 9b - Total employee contributionsClick to open row 36 in the field mapBox 37: 10 Amount allocable to IRR withinIRIS elementIRRAllocatedAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code B, B record 175-186CSV templateBox 10 - Amount allocable to IRR within 5 yearsClick to open row 37 in the field mapBox 38: 11 1st year of desig.IRIS elementDesignatedROTHAcctFirstYrRequiredOptional, four-digit yearPub 1220 (FIRE)B record 552-555CSV templateBox 11 - 1st year of designated Roth contributionsClick to open row 38 in the field mapBox 39: 12 FATCA filingIRIS elementFATCAFilingRequirementIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 556CSV templateFATCA Filing RequirementsClick to open row 39 in the field mapBox 40: 14 State tax withheldIRIS elementRequiredOptional, amountPub 1220 (FIRE)B record 723-734CSV templateState 1 - State tax withheld
State 2 - State tax withheld
Click to open row 40 in the field map
Box 41: 15 State/Payer's state no.IRIS element and RequiredOptionalPub 1220 (FIRE)B record 747-748 (CF/SF code) and 663-722 (special data entries)CSV templateState 1
State 1 - State/Payer state number
State 2
State 2 - State/Payer state number
Click to open row 41 in the field map
Box 42: 16 State distributionIRIS elementRequiredOptional, amountPub 1220 (FIRE)None: special data entries 663-722 at mostCSV templateState 1 - State income
State 2 - State income
Click to open row 42 in the field map
Box 43: Account number (see instructions)IRIS elementRecipientAccountNumRequiredOptional, up to 30 charactersPub 1220 (FIRE)B record 21-40CSV templateForm Account NumberClick to open row 43 in the field mapBox 44: 13 Date ofIRIS elementPaymentDtRequiredOptional, date YYYY-MM-DDPub 1220 (FIRE)B record 557-564CSV templateBox 13 - Date of PaymentClick to open row 44 in the field mapBox 45: 17 Local tax withheldIRIS elementRequiredOptional, amountPub 1220 (FIRE)B record 735-746CSV templateState 1 - Local income tax withheld
State 2 - Local income tax withheld
Click to open row 45 in the field map
Box 46: 18 Name of localityIRIS elementRequiredOptionalPub 1220 (FIRE)None: special data entries 663-722 at mostCSV templateNo column in the TY2025 templateClick to open row 46 in the field mapBox 47: 19 Local distributionIRIS elementRequiredOptional, amountPub 1220 (FIRE)None: special data entries 663-722 at mostCSV templateNo column in the TY2025 templateClick to open row 47 in the field map
Form 1099-R, Copy A, from IRS.gov, with the IRIS element for each box. Hover a box for its element, required flag and columns; click it to jump to its row in the field map, and click the row number to come back. The numbers match the field map below. Full-size image.

Field map: box by box

Element paths are relative to Form1099RDetail unless they start with IRSubmission. The grey part of a path is the group; the dark part is the element itself.

#Box on the formIRIS elementRequired, formatPub 1220 (FIRE)CSV column (TY2025)
1VOIDVoidIndRequired1 or 0None: FIRE has no void recordNot in the template
2CORRECTEDCorrectedInd, with PrevSubmittedRecRecipientGrp when 1Required1 or 0B record 6Not in the template
3PAYER'S nameorPersonNameName control optionalRequiredin the headerA record 53-92 (second name line 93-132); name control 21-24Payer Name TypePayer Business or Entity Name Line 1Payer Business or Entity Name Line 2
and 4 more columnsPayer First NamePayer Middle NamePayer Last Name (Surname)Payer Suffix
41 Gross distributionGrossDistributionAmtOptionalAmount, 2 decimalsAmount code 1, B record 55-66Box 1 - Gross distribution
5Calendar year (printed)TaxYrAlso in  and the manifestRequiredFour-digit yearB record 2-5Tax Year
6Street addressRequiredA record 134-173Payer Address Line 1
7Room or suite no.OptionalWithin A record 134-173 (FIRE has one address line)Payer Address Line 2
82a Taxable amountTaxableAmtOptionalAmount, 2 decimalsAmount code 2, B record 67-78Box 2a - Taxable amount
9City or townRequiredA record 174-213Payer City/Town
10Telephone numberOptionalA record 225-239Payer Phone TypePayer Phone
112b Taxable amount notTxblAmountNotDeterminedIndRequired1 or 0B record 547Box 2b - Taxable amount not determinedBox 2b - Total distribution
12TotalTotalDistributionIndRequired1 or 0B record 549Box 2b - Total distribution
13State or province ()Requiredfor a U.S. addressA record 214-215Payer State/Province/Territory
14CountryForeign address onlyA record 52 (foreign entity indicator); the address stays in 134-224Payer Country
15ZIP or foreign postal code ()Requiredfor a U.S. address5 or 9 digitsA record 216-224Payer ZIP/Postal Code
163 Capital gain (included inCapitalGainAmtOptionalAmount, 2 decimalsAmount code 3, B record 79-90Box 3 - Capital gain (included in box 2a)
174 Federal income taxFederalIncomeTaxWithheldAmtOptionalAmount, 2 decimalsAmount code 4, B record 91-102Box 4 - Federal income tax withheld
18PAYER'S TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)Required9 digitsA record 12-20Payer TIN TypePayer Taxpayer ID Number
19RECIPIENT'S TIN with Required9 digits, no dashesB record 12-20; TIN type 11Recipient TIN TypeRecipient Taxpayer ID Number
205 Employee contrib./EmployeeContributionsAmtOptionalAmount, 2 decimalsAmount code 5, B record 103-114Box 5 - Employee contributions/Designated Roth contributions or insurance premiums
216 NUA in employer'sNetUnrlzdSecuritiesApprcnAmtOptionalAmount, 2 decimalsAmount code 6, B record 115-126Box 6 - Net unrealized appreciation in employer's securities
22RECIPIENT'S nameorName control optionalRequired(one of the two)B record 288-367; name control 7-10Recipient Name TypeRecipient Business or Entity Name Line 1Recipient Business or Entity Name Line 2
and 4 more columnsRecipient First NameRecipient Middle NameRecipient Last Name (Surname)Recipient Suffix
237a Dist.Form1099RDistributionCdRequiredCode from a list of 120B record 545-546Box 7 - Distribution code(s)
247b IRA/SEP/IRASEPSIMPLEIndRequired1 or 0B record 548IRA/SEP/SIMPLE
257c TrumpTrumpAccountIndRequired1 or 0None in Pub 1220 (IRIS only)New box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet.
267d Earnings onExcessContributionsEarningsAmtOptionalAmount, 2 decimalsNone in Pub 1220 (IRIS only)New box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet.
27Street addressRequiredB record 368-407Recipient Address Line 1
28Apt. no.OptionalWithin B record 368-407 (FIRE has one address line)Recipient Address Line 2
29City or townRequiredB record 448-487Recipient City/Town
308a OtherOtherDistributionAmtOptionalAmount, 2 decimalsAmount code 8, B record 139-150Box 8 - Other ($)
318b Percentage of annuityRcpntOthDistributionPctOptionalDecimal 0 to 1B record 550-551Box 8 - Other (%)
32State or province ()Requiredfor a U.S. addressB record 488-489Recipient State/Province/Territory
33CountryForeign address onlyB record 287 (foreign country indicator); the address stays in 368-498Recipient Country
34ZIP or foreign postal code ()Requiredfor a U.S. address5 or 9 digitsB record 490-498Recipient ZIP/Postal Code
359a Percentage of total dist.RcpntTotalDistributionPctOptionalDecimal 0 to 1B record 550-551Box 9a - Your percentage of total distribution
369b Total employee contrib.TotalEmployeeContributionsAmtOptionalAmount, 2 decimalsAmount code 9, B record 151-162Box 9b - Total employee contributions
3710 Amount allocable to IRR withinIRRAllocatedAmtOptionalAmount, 2 decimalsAmount code B, B record 175-186Box 10 - Amount allocable to IRR within 5 years
3811 1st year of desig.DesignatedROTHAcctFirstYrOptionalFour-digit yearB record 552-555Box 11 - 1st year of designated Roth contributions
3912 FATCA filingFATCAFilingRequirementIndRequired1 or 0B record 556FATCA Filing Requirements
4014 State tax withheldOptionalAmountB record 723-734State 1 - State tax withheldState 2 - State tax withheld
4115 State/Payer's state no.andOptionalB record 747-748 (CF/SF code) and 663-722 (special data entries)State 1State 1 - State/Payer state numberState 2State 2 - State/Payer state number
4216 State distributionOptionalAmountNone: special data entries 663-722 at mostState 1 - State incomeState 2 - State income
43Account number (see instructions)RecipientAccountNumOptionalUp to 30 charactersB record 21-40Form Account Number
4413 Date ofPaymentDtOptionalDate YYYY-MM-DDB record 557-564Box 13 - Date of Payment
4517 Local tax withheldOptionalAmountB record 735-746State 1 - Local income tax withheldState 2 - Local income tax withheld
4618 Name of localityOptionalNone: special data entries 663-722 at mostNo column in the TY2025 template
4719 Local distributionOptionalAmountNone: special data entries 663-722 at mostNo column in the TY2025 template

Elements with no box on the form

IRIS elementRequired, formatPub 1220 (FIRE)
 RecordIdRequiredWhole number up to 8 digitsB record 500-507 (sequence number; not the same thing)
 IssuerOfficeCdOptionalExactly 4 charactersB record 41-44
 CFSFElectionStateCdOptionalTwo-letter state codeB record 747-748

Notes

  • Path: IRTransmission, IRSubmission1Grp, IRSubmission1Detail, Form1099RDetail (one per return). The filer (payer, lender, trustee or issuer) appears once, in the submission header, not in each return.
  • The state boxes have two lines on the form, one per state. In IRIS XML each line is one StateLocalTaxGrp and the group can repeat without limit; the portal CSV template has a State 1 and a State 2 set of columns. CFSFElectionStateCd (which states the IRS forwards the return to) is a separate, repeating element.

Form 1099-R business rules

Form 1099-R has 5 business rules of its own in the tax year 2026 rule set. What the severity means:

  • Report error, reject over threshold Each failing record is accepted with errors, until the share of failing records passes a threshold the IRS does not publish. Then the whole submission is rejected.
RuleSeverityWhat it checks
F1099R001Report error, reject over thresholdFederal income tax withheld looks too high compared with the income amounts reported on the form.
F1099R002Report error, reject over thresholdThe taxable amount cannot be more than the gross distribution.
F1099R003Report error, reject over thresholdThe capital gain amount cannot be more than the gross distribution.
F1099R005_001Report error, reject over thresholdNet unrealized appreciation in employer securities cannot be more than the gross distribution.
F1099R006Report error, reject over thresholdIf taxable amount not determined is checked and the IRA/SEP/SIMPLE box is not, the taxable amount must not be more than zero.

The descriptions are our own summaries; your IRIS acknowledgment gives the rule number. IRIS also checks the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN), listed on the rules every form shares page.

Every element of Form1099RDetail, in schema order

IRTransmission › IRSubmission1Grp › IRSubmission1Detail › Form1099RDetail

Each Form 1099-R return is one Form1099RDetail record in a submission of group 1. The table lists all 30 elements in schema order for tax year 2026, including the ones with no box on the form: whether each is required, and the format IRIS accepts. Element names are the ones the IRS uses in its IRIS ATS examples and Publication 5718; the IRS revises the schema each year. A FIRE filer converting a Pub 1220 file finds the field-by-field mapping in the Pub 1220 to IRIS crosswalk.

ElementRequiredFormat
TaxYrRequiredFour-digit year
RecordIdRequiredWhole number, up to 8 digits
IssuerOfficeCdOptionalExactly 4 characters
CFSFElectionStateCdOptionalTwo-letter state or territory code
VoidIndRequired1 (yes) or 0 (no)
CorrectedIndRequired1 (yes) or 0 (no)
PrevSubmittedRecRecipientGrpOptionalGroup of elements
OtherIntakeSystemIndRequired in the group1 (yes) or 0 (no) (1 when the original was filed outside IRIS)
OtherIntakeSystemNmOptionalGroup of elements (FIRE, for example)
UniqueRecordIdOptional (the IRIS original's record ID)
TINOptional9 digits, no dashes (original payee TIN)
PersonNameRequired in the groupGroup of elements (original payee name (or BusinessName))
BusinessNameRequired in the groupGroup of elements
RecipientDetailRequiredGroup of elements
RecipientAccountNumOptionalText, up to 30 characters
GrossDistributionAmtOptionalAmount, zero or more, up to 2 decimal places
TaxableAmtOptionalAmount, zero or more, up to 2 decimal places
TxblAmountNotDeterminedIndRequired1 (yes) or 0 (no)
TotalDistributionIndRequired1 (yes) or 0 (no)
CapitalGainAmtOptionalAmount, zero or more, up to 2 decimal places
FederalIncomeTaxWithheldAmtOptionalAmount, zero or more, up to 2 decimal places
EmployeeContributionsAmtOptionalAmount, zero or more, up to 2 decimal places
NetUnrlzdSecuritiesApprcnAmtOptionalAmount, zero or more, up to 2 decimal places
Form1099RDistributionCdRequiredCode from a list of 120 values
IRASEPSIMPLEIndRequired1 (yes) or 0 (no)
TrumpAccountIndRequired1 (yes) or 0 (no)
ExcessContributionsEarningsAmtOptionalAmount, zero or more, up to 2 decimal places
OtherDistributionAmtOptionalAmount, zero or more, up to 2 decimal places
RcpntOthDistributionPctOptionalDecimal from 0 to 1, up to 5 decimal places
RcpntTotalDistributionPctOptionalDecimal from 0 to 1, up to 5 decimal places
TotalEmployeeContributionsAmtOptionalAmount, zero or more, up to 2 decimal places
IRRAllocatedAmtOptionalAmount, zero or more, up to 2 decimal places
DesignatedROTHAcctFirstYrOptionalFour-digit year
FATCAFilingRequirementIndRequired1 (yes) or 0 (no)
PaymentDtOptionalDate, YYYY-MM-DD
StateLocalTaxGrpOptional, repeatsGroup of elements
StateAbbreviationCdRequired in the groupTwo-letter state or territory code (the state this group is for)
StateTaxGrp/StateIdNumOptionaltext (state or payer's state number)
StateTaxGrp/StateTaxWithheldAmtOptionalAmount, zero or more, up to 2 decimal places (state tax withheld)
StateTaxGrp/StateIncomeAmtOptionalAmount, zero or more, up to 2 decimal places (state income)
StateTaxGrp/StateDistributionAmtOptionalAmount, zero or more, up to 2 decimal places (state distribution: a Form 1099-R box; the shared group carries it on every form)
LocalTaxGrp/LocalTaxWithheldAmtOptionalAmount, zero or more, up to 2 decimal places (local tax withheld)
LocalTaxGrp/LocalIncomeAmtOptionalAmount, zero or more, up to 2 decimal places (local income)
LocalTaxGrp/LocalityNmOptionalText, up to 20 characters (name of locality)
LocalTaxGrp/LocalAbbreviationCdTxtOptionaltext (local abbreviation)
LocalTaxGrp/LocalDistributionAmtOptionalAmount, zero or more, up to 2 decimal places (local distribution: a Form 1099-R box; the shared group carries it on every form)
SpecialDataEntriesTxtOptionaltext (special data entries)

CSV template columns: the IRIS Taxpayer Portal upload

The portal takes Form 1099-R as a CSV upload built on the IRS template for the form. The tax year 2025 template has 67 columns (18 required); the IRS has not published tax year 2026 templates, and a template is tied to its tax year. The column letter is the spreadsheet column and the format is from the IRS Template Formatting Guidelines; the IRIS element behind each box is in the field map above. Download a sample 1099-R CSV with two fictitious records in this layout, for seeing the shape of the file, not for uploading; check a real file with the IRIS CSV upload checker.

Col.Template columnRequiredFormat
AForm TypeOptionalform type, filled in by the template
BTax YearOptionaltax year
CPayer TIN TypeRequiredTIN type: EIN, SSN
DPayer Taxpayer ID NumberRequiredTIN with dashes (XX-XXXXXXX or XXX-XX-XXXX)
EPayer Name TypeRequiredB (business) or I (individual): B, I
FPayer Business or Entity Name Line 1Requiredtext; up to 40 characters
GPayer Business or Entity Name Line 2Optionaltext; up to 40 characters
HPayer First NameRequiredtext; up to 20 characters
IPayer Middle NameOptionaltext; up to 20 characters
JPayer Last Name (Surname)Requiredtext; up to 20 characters
KPayer SuffixOptionaltext; up to 20 characters
LPayer CountryRequiredcountry code (US for United States)
MPayer Address Line 1Requiredtext; up to 35 characters
NPayer Address Line 2Optionaltext; up to 35 characters
OPayer City/TownRequiredtext; up to 40 characters
PPayer State/Province/TerritoryRequiredtwo-letter state (or province, up to 17 characters); up to 17 characters
QPayer ZIP/Postal CodeRequiredZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters
RPayer Phone TypeOptionalD (domestic) or I (international): D, I
SPayer PhoneOptionalphone, 10 digits
TRecipient TIN TypeOptionalTIN type: ATIN, EIN, ITIN, QI-EIN, SSN, UND
URecipient Taxpayer ID NumberOptionalTIN with dashes (XX-XXXXXXX or XXX-XX-XXXX)
VRecipient Name TypeRequiredB (business) or I (individual): B, I
WRecipient Business or Entity Name Line 1Optionaltext; up to 40 characters
XRecipient Business or Entity Name Line 2Optionaltext; up to 40 characters
YRecipient First NameOptionaltext; up to 20 characters
ZRecipient Middle NameOptionaltext; up to 20 characters
AARecipient Last Name (Surname)Optionaltext; up to 20 characters
ABRecipient SuffixOptionaltext; up to 20 characters
ACRecipient CountryRequiredcountry code (US for United States)
ADRecipient Address Line 1Requiredtext; up to 35 characters
AERecipient Address Line 2Optionaltext; up to 35 characters
AFRecipient City/TownRequiredtext; up to 40 characters
AGRecipient State/Province/TerritoryRequiredtwo-letter state (or province, up to 17 characters); up to 17 characters
AHRecipient ZIP/Postal CodeRequiredZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters
AIOffice CodeOptional4 characters
AJForm Account NumberOptionaltext; up to 20 characters
AKFATCA Filing RequirementsOptionalY or N
ALBox 1 - Gross distributionOptionalamount, no $ or commas
AMBox 2a - Taxable amountOptionalamount, no $ or commas
ANBox 2b - Taxable amount not determinedOptionalY or N
AOBox 2b - Total distributionOptionalY or N
APBox 3 - Capital gain (included in box 2a)Optionalamount, no $ or commas
AQBox 4 - Federal income tax withheldOptionalamount, no $ or commas
ARBox 5 - Employee contributions/Designated Roth contributions or insurance premiumsOptionalamount, no $ or commas
ASBox 6 - Net unrealized appreciation in employer's securitiesOptionalamount, no $ or commas
ATBox 7 - Distribution code(s)Requiredtext; up to 2 characters
AUIRA/SEP/SIMPLEOptionalY or N
AVBox 8 - Other ($)Optionalamount, no $ or commas
AWBox 8 - Other (%)Optionaltext; up to 5 characters
AXBox 9a - Your percentage of total distributionOptionaltext; up to 5 characters
AYBox 9b - Total employee contributionsOptionalamount, no $ or commas
AZBox 10 - Amount allocable to IRR within 5 yearsOptionalamount, no $ or commas
BABox 11 - 1st year of designated Roth contributionsOptionaltext; up to 4 characters
BBBox 13 - Date of PaymentOptionalMM/DD/YYYY
BCCombined Federal/State FilingOptionalstate codes separated by commas, in quotes
BDState 1Optionaltwo-letter state (or province, up to 17 characters)
BEState 1 - State tax withheldOptionalamount, no $ or commas
BFState 1 - State/Payer state numberOptionaltext; up to 24 characters
BGState 1 - State incomeOptionalamount, no $ or commas
BHState 1 - Local income tax withheldOptionalamount, no $ or commas
BIState 1 - Special Data EntriesOptionaltext; up to 60 characters
BJState 2Optionaltwo-letter state (or province, up to 17 characters)
BKState 2 - State tax withheldOptionalamount, no $ or commas
BLState 2 - State/Payer state numberOptionaltext; up to 24 characters
BMState 2 - State incomeOptionalamount, no $ or commas
BNState 2 - Local income tax withheldOptionalamount, no $ or commas
BOState 2 - Special Data EntriesOptionaltext; up to 60 characters

Check a file before you send it. TIN Comply's free IRIS 1099 File Checker runs an IRIS XML or CSV file against the IRS business rules in your browser.

See also: 1099-R distribution code finder.