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.
Box 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 TypePayer Business or Entity Name Line 1
Payer Business or Entity Name Line 2
Payer First Name
Payer Middle Name
Payer Last Name (Surname)
Payer SuffixClick to open row 3 in the field mapBox 4: 1 Gross distributionIRIS element
GrossDistributionAmtRequiredOptional, 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 TypePayer PhoneClick to open row 10 in the field mapBox 11: 2b Taxable amount notIRIS element
TxblAmountNotDeterminedIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 547CSV templateBox 2b - Taxable amount not determinedBox 2b - Total distributionClick to open row 11 in the field mapBox 12: TotalIRIS element
TotalDistributionIndRequiredRequired, 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 TypePayer Taxpayer ID NumberClick to open row 18 in the field mapBox 19: RECIPIENT'S TINIRIS element
with RequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateRecipient TIN TypeRecipient Taxpayer ID NumberClick to open row 19 in the field mapBox 20: 5 Employee contrib./IRIS element
EmployeeContributionsAmtRequiredOptional, 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 TypeRecipient Business or Entity Name Line 1
Recipient Business or Entity Name Line 2
Recipient First Name
Recipient Middle Name
Recipient Last Name (Surname)
Recipient SuffixClick to open row 22 in the field mapBox 23: 7a Dist.IRIS element
Form1099RDistributionCdRequiredRequired, 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 withheldState 2 - State tax withheldClick to open row 40 in the field mapBox 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 1State 1 - State/Payer state number
State 2
State 2 - State/Payer state numberClick to open row 41 in the field mapBox 42: 16 State distributionIRIS element
RequiredOptional, amountPub 1220 (FIRE)None: special data entries 663-722 at mostCSV templateState 1 - State incomeState 2 - State incomeClick to open row 42 in the field mapBox 43: Account number (see instructions)IRIS element
RecipientAccountNumRequiredOptional, 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 withheldState 2 - Local income tax withheldClick to open row 45 in the field mapBox 46: 18 Name of localityIRIS element
RequiredOptionalPub 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 mapField 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 form | IRIS element | Required, format | Pub 1220 (FIRE) | CSV column (TY2025) |
|---|---|---|---|---|---|
| 1 | VOID | Void | Required1 or 0 | None: FIRE has no void record | Not in the template |
| 2 | CORRECTED | Corrected, with Prev when 1 | Required1 or 0 | B record 6 | Not in the template |
| 3 | PAYER'S name | orPersonName control optional | Requiredin the header | A record 53-92 (second name line 93-132); name control 21-24 | Payer Name TypePayer Business or Entity Name Line 1Payer Business or Entity Name Line 2and 4 more columnsPayer First NamePayer Middle NamePayer Last Name (Surname)Payer Suffix |
| 4 | 1 Gross distribution | Gross | OptionalAmount, 2 decimals | Amount code 1, B record 55-66 | Box 1 - Gross distribution |
| 5 | Calendar year (printed) | TaxAlso in and the manifest | RequiredFour-digit year | B record 2-5 | Tax Year |
| 6 | Street address | | Required | A record 134-173 | Payer Address Line 1 |
| 7 | Room or suite no. | | Optional | Within A record 134-173 (FIRE has one address line) | Payer Address Line 2 |
| 8 | 2a Taxable amount | Taxable | OptionalAmount, 2 decimals | Amount code 2, B record 67-78 | Box 2a - Taxable amount |
| 9 | City or town | | Required | A record 174-213 | Payer City/ |
| 10 | Telephone number | | Optional | A record 225-239 | Payer Phone TypePayer Phone |
| 11 | 2b Taxable amount not | Txbl | Required1 or 0 | B record 547 | Box 2b - Taxable amount not determinedBox 2b - Total distribution |
| 12 | Total | Total | Required1 or 0 | B record 549 | Box 2b - Total distribution |
| 13 | State or province | () | Requiredfor a U.S. address | A record 214-215 | Payer State/ |
| 14 | Country | | Foreign address only | A record 52 (foreign entity indicator); the address stays in 134-224 | Payer Country |
| 15 | ZIP or foreign postal code | () | Requiredfor a U.S. address5 or 9 digits | A record 216-224 | Payer ZIP/ |
| 16 | 3 Capital gain (included in | Capital | OptionalAmount, 2 decimals | Amount code 3, B record 79-90 | Box 3 - Capital gain (included in box 2a) |
| 17 | 4 Federal income tax | Federal | OptionalAmount, 2 decimals | Amount code 4, B record 91-102 | Box 4 - Federal income tax withheld |
| 18 | PAYER'S TIN | with TINSubmitted (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN) | Required9 digits | A record 12-20 | Payer TIN TypePayer Taxpayer ID Number |
| 19 | RECIPIENT'S TIN | with | Required9 digits, no dashes | B record 12-20; TIN type 11 | Recipient TIN TypeRecipient Taxpayer ID Number |
| 20 | 5 Employee contrib./ | Employee | OptionalAmount, 2 decimals | Amount code 5, B record 103-114 | Box 5 - Employee contributions/ |
| 21 | 6 NUA in employer's | Net | OptionalAmount, 2 decimals | Amount code 6, B record 115-126 | Box 6 - Net unrealized appreciation in employer's securities |
| 22 | RECIPIENT'S name | orName control optional | Required(one of the two) | B record 288-367; name control 7-10 | Recipient Name TypeRecipient Business or Entity Name Line 1Recipient Business or Entity Name Line 2and 4 more columnsRecipient First NameRecipient Middle NameRecipient Last Name (Surname)Recipient Suffix |
| 23 | 7a Dist. | Form1099 | RequiredCode from a list of 120 | B record 545-546 | Box 7 - Distribution code(s) |
| 24 | 7b IRA/SEP/ | IRASEPSIMPLEInd | Required1 or 0 | B record 548 | IRA/ |
| 25 | 7c Trump | Trump | Required1 or 0 | None in Pub 1220 (IRIS only) | New box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet. |
| 26 | 7d Earnings on | Excess | OptionalAmount, 2 decimals | None in Pub 1220 (IRIS only) | New box for 2026: no column in the TY2025 template. The IRS has not published the TY2026 templates yet. |
| 27 | Street address | | Required | B record 368-407 | Recipient Address Line 1 |
| 28 | Apt. no. | | Optional | Within B record 368-407 (FIRE has one address line) | Recipient Address Line 2 |
| 29 | City or town | | Required | B record 448-487 | Recipient City/ |
| 30 | 8a Other | Other | OptionalAmount, 2 decimals | Amount code 8, B record 139-150 | Box 8 - Other ($) |
| 31 | 8b Percentage of annuity | Rcpnt | OptionalDecimal 0 to 1 | B record 550-551 | Box 8 - Other (%) |
| 32 | State or province | () | Requiredfor a U.S. address | B record 488-489 | Recipient State/ |
| 33 | Country | | Foreign address only | B record 287 (foreign country indicator); the address stays in 368-498 | Recipient Country |
| 34 | ZIP or foreign postal code | () | Requiredfor a U.S. address5 or 9 digits | B record 490-498 | Recipient ZIP/ |
| 35 | 9a Percentage of total dist. | Rcpnt | OptionalDecimal 0 to 1 | B record 550-551 | Box 9a - Your percentage of total distribution |
| 36 | 9b Total employee contrib. | Total | OptionalAmount, 2 decimals | Amount code 9, B record 151-162 | Box 9b - Total employee contributions |
| 37 | 10 Amount allocable to IRR within | IRRAllocated | OptionalAmount, 2 decimals | Amount code B, B record 175-186 | Box 10 - Amount allocable to IRR within 5 years |
| 38 | 11 1st year of desig. | Designated | OptionalFour-digit year | B record 552-555 | Box 11 - 1st year of designated Roth contributions |
| 39 | 12 FATCA filing | FATCAFiling | Required1 or 0 | B record 556 | FATCA Filing Requirements |
| 40 | 14 State tax withheld | | OptionalAmount | B record 723-734 | State 1 - State tax withheldState 2 - State tax withheld |
| 41 | 15 State/Payer's state no. | and | Optional | B record 747-748 (CF/SF code) and 663-722 (special data entries) | State 1State 1 - State/ |
| 42 | 16 State distribution | | OptionalAmount | None: special data entries 663-722 at most | State 1 - State incomeState 2 - State income |
| 43 | Account number (see instructions) | Recipient | OptionalUp to 30 characters | B record 21-40 | Form Account Number |
| 44 | 13 Date of | Payment | OptionalDate YYYY-MM-DD | B record 557-564 | Box 13 - Date of Payment |
| 45 | 17 Local tax withheld | | OptionalAmount | B record 735-746 | State 1 - Local income tax withheldState 2 - Local income tax withheld |
| 46 | 18 Name of locality | | Optional | None: special data entries 663-722 at most | No column in the TY2025 template |
| 47 | 19 Local distribution | | OptionalAmount | None: special data entries 663-722 at most | No column in the TY2025 template |
Elements with no box on the form
| IRIS element | Required, format | Pub 1220 (FIRE) | |
|---|---|---|---|
Record | RequiredWhole number up to 8 digits | B record 500-507 (sequence number; not the same thing) | |
Issuer | OptionalExactly 4 characters | B record 41-44 | |
CFSFElection | OptionalTwo-letter state code | B 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
StateLocalTaxGrpand 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.
| Rule | Severity | What it checks |
|---|---|---|
F1099R001 | Report error, reject over threshold | Federal income tax withheld looks too high compared with the income amounts reported on the form. |
F1099R002 | Report error, reject over threshold | The taxable amount cannot be more than the gross distribution. |
F1099R003 | Report error, reject over threshold | The capital gain amount cannot be more than the gross distribution. |
F1099R005_001 | Report error, reject over threshold | Net unrealized appreciation in employer securities cannot be more than the gross distribution. |
F1099R006 | Report error, reject over threshold | If 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 › Form1099RDetailEach 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.
| Element | Required | Format |
|---|---|---|
TaxYr | Required | Four-digit year |
RecordId | Required | Whole number, up to 8 digits |
IssuerOfficeCd | Optional | Exactly 4 characters |
CFSFElectionStateCd | Optional | Two-letter state or territory code |
VoidInd | Required | 1 (yes) or 0 (no) |
CorrectedInd | Required | 1 (yes) or 0 (no) |
PrevSubmittedRecRecipientGrp | Optional | Group of elements |
OtherIntakeSystemInd | Required in the group | 1 (yes) or 0 (no) (1 when the original was filed outside IRIS) |
OtherIntakeSystemNm | Optional | Group of elements (FIRE, for example) |
UniqueRecordId | Optional | (the IRIS original's record ID) |
TIN | Optional | 9 digits, no dashes (original payee TIN) |
PersonName | Required in the group | Group of elements (original payee name (or BusinessName)) |
BusinessName | Required in the group | Group of elements |
RecipientDetail | Required | Group of elements |
RecipientAccountNum | Optional | Text, up to 30 characters |
GrossDistributionAmt | Optional | Amount, zero or more, up to 2 decimal places |
TaxableAmt | Optional | Amount, zero or more, up to 2 decimal places |
TxblAmountNotDeterminedInd | Required | 1 (yes) or 0 (no) |
TotalDistributionInd | Required | 1 (yes) or 0 (no) |
CapitalGainAmt | Optional | Amount, zero or more, up to 2 decimal places |
FederalIncomeTaxWithheldAmt | Optional | Amount, zero or more, up to 2 decimal places |
EmployeeContributionsAmt | Optional | Amount, zero or more, up to 2 decimal places |
NetUnrlzdSecuritiesApprcnAmt | Optional | Amount, zero or more, up to 2 decimal places |
Form1099RDistributionCd | Required | Code from a list of 120 values |
IRASEPSIMPLEInd | Required | 1 (yes) or 0 (no) |
TrumpAccountInd | Required | 1 (yes) or 0 (no) |
ExcessContributionsEarningsAmt | Optional | Amount, zero or more, up to 2 decimal places |
OtherDistributionAmt | Optional | Amount, zero or more, up to 2 decimal places |
RcpntOthDistributionPct | Optional | Decimal from 0 to 1, up to 5 decimal places |
RcpntTotalDistributionPct | Optional | Decimal from 0 to 1, up to 5 decimal places |
TotalEmployeeContributionsAmt | Optional | Amount, zero or more, up to 2 decimal places |
IRRAllocatedAmt | Optional | Amount, zero or more, up to 2 decimal places |
DesignatedROTHAcctFirstYr | Optional | Four-digit year |
FATCAFilingRequirementInd | Required | 1 (yes) or 0 (no) |
PaymentDt | Optional | Date, YYYY-MM-DD |
StateLocalTaxGrp | Optional, repeats | Group of elements |
StateAbbreviationCd | Required in the group | Two-letter state or territory code (the state this group is for) |
StateTaxGrp/StateIdNum | Optional | text (state or payer's state number) |
StateTaxGrp/StateTaxWithheldAmt | Optional | Amount, zero or more, up to 2 decimal places (state tax withheld) |
StateTaxGrp/StateIncomeAmt | Optional | Amount, zero or more, up to 2 decimal places (state income) |
StateTaxGrp/StateDistributionAmt | Optional | Amount, zero or more, up to 2 decimal places (state distribution: a Form 1099-R box; the shared group carries it on every form) |
LocalTaxGrp/LocalTaxWithheldAmt | Optional | Amount, zero or more, up to 2 decimal places (local tax withheld) |
LocalTaxGrp/LocalIncomeAmt | Optional | Amount, zero or more, up to 2 decimal places (local income) |
LocalTaxGrp/LocalityNm | Optional | Text, up to 20 characters (name of locality) |
LocalTaxGrp/LocalAbbreviationCdTxt | Optional | text (local abbreviation) |
LocalTaxGrp/LocalDistributionAmt | Optional | Amount, zero or more, up to 2 decimal places (local distribution: a Form 1099-R box; the shared group carries it on every form) |
SpecialDataEntriesTxt | Optional | text (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 column | Required | Format |
|---|---|---|---|
| A | Form Type | Optional | form type, filled in by the template |
| B | Tax Year | Optional | tax year |
| C | Payer TIN Type | Required | TIN type: EIN, SSN |
| D | Payer Taxpayer ID Number | Required | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| E | Payer Name Type | Required | B (business) or I (individual): B, I |
| F | Payer Business or Entity Name Line 1 | Required | text; up to 40 characters |
| G | Payer Business or Entity Name Line 2 | Optional | text; up to 40 characters |
| H | Payer First Name | Required | text; up to 20 characters |
| I | Payer Middle Name | Optional | text; up to 20 characters |
| J | Payer Last Name (Surname) | Required | text; up to 20 characters |
| K | Payer Suffix | Optional | text; up to 20 characters |
| L | Payer Country | Required | country code (US for United States) |
| M | Payer Address Line 1 | Required | text; up to 35 characters |
| N | Payer Address Line 2 | Optional | text; up to 35 characters |
| O | Payer City/Town | Required | text; up to 40 characters |
| P | Payer State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| Q | Payer ZIP/Postal Code | Required | ZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters |
| R | Payer Phone Type | Optional | D (domestic) or I (international): D, I |
| S | Payer Phone | Optional | phone, 10 digits |
| T | Recipient TIN Type | Optional | TIN type: ATIN, EIN, ITIN, QI-EIN, SSN, UND |
| U | Recipient Taxpayer ID Number | Optional | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| V | Recipient Name Type | Required | B (business) or I (individual): B, I |
| W | Recipient Business or Entity Name Line 1 | Optional | text; up to 40 characters |
| X | Recipient Business or Entity Name Line 2 | Optional | text; up to 40 characters |
| Y | Recipient First Name | Optional | text; up to 20 characters |
| Z | Recipient Middle Name | Optional | text; up to 20 characters |
| AA | Recipient Last Name (Surname) | Optional | text; up to 20 characters |
| AB | Recipient Suffix | Optional | text; up to 20 characters |
| AC | Recipient Country | Required | country code (US for United States) |
| AD | Recipient Address Line 1 | Required | text; up to 35 characters |
| AE | Recipient Address Line 2 | Optional | text; up to 35 characters |
| AF | Recipient City/Town | Required | text; up to 40 characters |
| AG | Recipient State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| AH | Recipient ZIP/Postal Code | Required | ZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters |
| AI | Office Code | Optional | 4 characters |
| AJ | Form Account Number | Optional | text; up to 20 characters |
| AK | FATCA Filing Requirements | Optional | Y or N |
| AL | Box 1 - Gross distribution | Optional | amount, no $ or commas |
| AM | Box 2a - Taxable amount | Optional | amount, no $ or commas |
| AN | Box 2b - Taxable amount not determined | Optional | Y or N |
| AO | Box 2b - Total distribution | Optional | Y or N |
| AP | Box 3 - Capital gain (included in box 2a) | Optional | amount, no $ or commas |
| AQ | Box 4 - Federal income tax withheld | Optional | amount, no $ or commas |
| AR | Box 5 - Employee contributions/Designated Roth contributions or insurance premiums | Optional | amount, no $ or commas |
| AS | Box 6 - Net unrealized appreciation in employer's securities | Optional | amount, no $ or commas |
| AT | Box 7 - Distribution code(s) | Required | text; up to 2 characters |
| AU | IRA/SEP/SIMPLE | Optional | Y or N |
| AV | Box 8 - Other ($) | Optional | amount, no $ or commas |
| AW | Box 8 - Other (%) | Optional | text; up to 5 characters |
| AX | Box 9a - Your percentage of total distribution | Optional | text; up to 5 characters |
| AY | Box 9b - Total employee contributions | Optional | amount, no $ or commas |
| AZ | Box 10 - Amount allocable to IRR within 5 years | Optional | amount, no $ or commas |
| BA | Box 11 - 1st year of designated Roth contributions | Optional | text; up to 4 characters |
| BB | Box 13 - Date of Payment | Optional | MM/DD/YYYY |
| BC | Combined Federal/State Filing | Optional | state codes separated by commas, in quotes |
| BD | State 1 | Optional | two-letter state (or province, up to 17 characters) |
| BE | State 1 - State tax withheld | Optional | amount, no $ or commas |
| BF | State 1 - State/Payer state number | Optional | text; up to 24 characters |
| BG | State 1 - State income | Optional | amount, no $ or commas |
| BH | State 1 - Local income tax withheld | Optional | amount, no $ or commas |
| BI | State 1 - Special Data Entries | Optional | text; up to 60 characters |
| BJ | State 2 | Optional | two-letter state (or province, up to 17 characters) |
| BK | State 2 - State tax withheld | Optional | amount, no $ or commas |
| BL | State 2 - State/Payer state number | Optional | text; up to 24 characters |
| BM | State 2 - State income | Optional | amount, no $ or commas |
| BN | State 2 - Local income tax withheld | Optional | amount, no $ or commas |
| BO | State 2 - Special Data Entries | Optional | text; 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.