The form, box by box: where each box goes in IRIS
Copy A of Form 1098-E, 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: RECIPIENT'S/LENDER'S nameIRIS elementIRSubmission1Header/IssuerDetail/BusinessName/ BusinessNameLine1Txt (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 templateLender Name TypeLender Business or Entity Name Line 1
Lender Business or Entity Name Line 2
Lender First Name
Lender Middle Name
Lender Last Name (Surname)
Lender SuffixClick to open row 3 in the field mapBox 4: Calendar year (printed)IRIS element
TaxYr (also IRSubmission1Header/ TaxYr and the manifest)RequiredRequired, four-digit yearPub 1220 (FIRE)B record 2-5CSV templateTax YearClick to open row 4 in the field mapBox 5: Street addressIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ AddressLine1TxtRequiredRequiredPub 1220 (FIRE)A record 134-173CSV templateLender Address Line 1Click to open row 5 in the field mapBox 6: Room/suite no.IRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ AddressLine2TxtRequiredOptionalPub 1220 (FIRE)Within A record 134-173 (FIRE has one address line)CSV templateLender Address Line 2Click to open row 6 in the field mapBox 7: City/townIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ CityNmRequiredRequiredPub 1220 (FIRE)A record 174-213CSV templateLender City/TownClick to open row 7 in the field mapBox 8: State/provinceIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ StateAbbreviationCd (ForeignAddress/ ProvinceOrStateNm)RequiredRequired for a U.S. addressPub 1220 (FIRE)A record 214-215CSV templateLender State/Province/TerritoryClick to open row 8 in the field mapBox 9: CountryIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/ForeignAddress/ CountryCdRequiredForeign address onlyPub 1220 (FIRE)A record 52 (foreign entity indicator); the address stays in 134-224CSV templateLender CountryClick to open row 9 in the field mapBox 10: ZIP/foreign codeIRIS elementIRSubmission1Header/IssuerDetail/MailingAddressGrp/USAddress/ ZIPCd (ForeignAddress/ ForeignPostalCd)RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)A record 216-224CSV templateLender ZIP/Postal CodeClick to open row 10 in the field mapBox 11: Telephone number:IRIS elementIRSubmission1Header/IssuerDetail/ PhoneNumRequiredOptionalPub 1220 (FIRE)A record 225-239CSV templateLender Phone TypeLender PhoneClick to open row 11 in the field mapBox 12: 1 Student loan interest received by lenderIRIS element
StudentLoanIntRcvdByLenderAmtRequiredRequired, amount, 2 decimalsPub 1220 (FIRE)Amount code 1, B record 55-66CSV templateBox 1 - InterestClick to open row 12 in the field mapBox 13: RECIPIENT'S TINIRIS elementIRSubmission1Header/IssuerDetail/ TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)RequiredRequired, 9 digitsPub 1220 (FIRE)A record 12-20CSV templateLender TIN TypeLender Taxpayer ID NumberClick to open row 13 in the field mapBox 14: BORROWER'S TINIRIS element
RecipientDetail/ TIN with RecipientDetail/ TINSubmittedTypeCdRequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateBorrower TIN TypeBorrower Taxpayer ID NumberClick to open row 14 in the field mapBox 15: BORROWER'S nameIRIS element
RecipientDetail/ PersonName (PersonFirstNm, PersonMiddleNm, PersonLastNm, SuffixNm) or RecipientDetail/BusinessName/ BusinessNameLine1Txt 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 templateBorrower First NameBorrower Middle Name
Borrower Last Name (Surname)
Borrower SuffixClick to open row 15 in the field mapBox 16: Street addressIRIS element
RecipientDetail/MailingAddressGrp/USAddress/ AddressLine1TxtRequiredRequiredPub 1220 (FIRE)B record 368-407CSV templateBorrower Address Line 1Click to open row 16 in the field mapBox 17: Apt. no.IRIS elementRecipientDetail/MailingAddressGrp/USAddress/ AddressLine2TxtRequiredOptionalPub 1220 (FIRE)Within B record 368-407 (FIRE has one address line)CSV templateBorrower Address Line 2Click to open row 17 in the field mapBox 18: City/townIRIS elementRecipientDetail/MailingAddressGrp/USAddress/ CityNmRequiredRequiredPub 1220 (FIRE)B record 448-487CSV templateBorrower City/TownClick to open row 18 in the field mapBox 19: State/provinceIRIS elementRecipientDetail/MailingAddressGrp/USAddress/ StateAbbreviationCd (ForeignAddress/ ProvinceOrStateNm)RequiredRequired for a U.S. addressPub 1220 (FIRE)B record 488-489CSV templateBorrower State/Province/TerritoryClick to open row 19 in the field mapBox 20: CountryIRIS elementRecipientDetail/MailingAddressGrp/ForeignAddress/ CountryCdRequiredForeign address onlyPub 1220 (FIRE)B record 287 (foreign country indicator); the address stays in 368-498CSV templateBorrower CountryClick to open row 20 in the field mapBox 21: ZIP/foreign codeIRIS elementRecipientDetail/MailingAddressGrp/USAddress/ ZIPCd (ForeignAddress/ ForeignPostalCd)RequiredRequired for a U.S. address, 5 or 9 digitsPub 1220 (FIRE)B record 490-498CSV templateBorrower ZIP/Postal CodeClick to open row 21 in the field mapBox 22: Account number (see instructions)IRIS elementRecipientAccountNumRequiredOptional, up to 30 charactersPub 1220 (FIRE)B record 21-40CSV templateForm Account NumberClick to open row 22 in the field mapBox 23: 2 Check if box 1 does not include loan origination feesIRIS elementNotLoanOrigFeeOrCapInterestIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 547CSV templateBox 2 - Origination FeesClick to open row 23 in the field mapField map: box by box
Element paths are relative to Form1098EDetail 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 | RECIPIENT'S/LENDER'S name | IRSubmission1Header/orPersonName control optional | Requiredin the header | A record 53-92 (second name line 93-132); name control 21-24 | Lender Name TypeLender Business or Entity Name Line 1Lender Business or Entity Name Line 2and 4 more columnsLender First NameLender Middle NameLender Last Name (Surname)Lender Suffix |
| 4 | Calendar year (printed) | TaxAlso in IRSubmission1Header/ and the manifest | RequiredFour-digit year | B record 2-5 | Tax Year |
| 5 | Street address | IRSubmission1Header/ | Required | A record 134-173 | Lender Address Line 1 |
| 6 | Room/suite no. | IRSubmission1Header/ | Optional | Within A record 134-173 (FIRE has one address line) | Lender Address Line 2 |
| 7 | City/town | IRSubmission1Header/ | Required | A record 174-213 | Lender City/ |
| 8 | State/province | IRSubmission1Header/ (ForeignAddress/) | Requiredfor a U.S. address | A record 214-215 | Lender State/ |
| 9 | Country | IRSubmission1Header/ | Foreign address only | A record 52 (foreign entity indicator); the address stays in 134-224 | Lender Country |
| 10 | ZIP/foreign code | IRSubmission1Header/ (ForeignAddress/) | Requiredfor a U.S. address5 or 9 digits | A record 216-224 | Lender ZIP/ |
| 11 | Telephone number: | IRSubmission1Header/ | Optional | A record 225-239 | Lender Phone TypeLender Phone |
| 12 | 1 Student loan interest received by lender | Student | RequiredAmount, 2 decimals | Amount code 1, B record 55-66 | Box 1 - Interest |
| 13 | RECIPIENT'S TIN | IRSubmission1Header/ with TINSubmitted (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN) | Required9 digits | A record 12-20 | Lender TIN TypeLender Taxpayer ID Number |
| 14 | BORROWER'S TIN | RecipientDetail/ with RecipientDetail/ | Required9 digits, no dashes | B record 12-20; TIN type 11 | Borrower TIN TypeBorrower Taxpayer ID Number |
| 15 | BORROWER'S name | RecipientDetail/orRecipientDetail/Name control optional | Required(one of the two) | B record 288-367; name control 7-10 | Borrower First NameBorrower Middle NameBorrower Last Name (Surname)Borrower Suffix |
| 16 | Street address | RecipientDetail/ | Required | B record 368-407 | Borrower Address Line 1 |
| 17 | Apt. no. | RecipientDetail/ | Optional | Within B record 368-407 (FIRE has one address line) | Borrower Address Line 2 |
| 18 | City/town | RecipientDetail/ | Required | B record 448-487 | Borrower City/ |
| 19 | State/province | RecipientDetail/ (ForeignAddress/) | Requiredfor a U.S. address | B record 488-489 | Borrower State/ |
| 20 | Country | RecipientDetail/ | Foreign address only | B record 287 (foreign country indicator); the address stays in 368-498 | Borrower Country |
| 21 | ZIP/foreign code | RecipientDetail/ (ForeignAddress/) | Requiredfor a U.S. address5 or 9 digits | B record 490-498 | Borrower ZIP/ |
| 22 | Account number (see instructions) | Recipient | OptionalUp to 30 characters | B record 21-40 | Form Account Number |
| 23 | 2 Check if box 1 does not include loan origination fees | Not | Required1 or 0 | B record 547 | Box 2 - Origination Fees |
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 |
Notes
- Path:
IRTransmission,IRSubmission1Grp,IRSubmission1Detail,Form1098EDetail(one per return). The filer (payer, lender, trustee or issuer) appears once, in the submission header, not in each return.
Form 1098-E business rules
The IRS rule sets for tax years 2022 to 2026 contain no rule numbered for Form 1098-E. Its returns are still checked against the schema and against the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN), listed on the rules every form shares page.
Every element of Form1098EDetail, in schema order
IRTransmission › IRSubmission1Grp › IRSubmission1Detail › Form1098EDetailEach Form 1098-E return is one Form1098EDetail record in a submission of group 1. The table lists all 10 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 |
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 |
StudentLoanIntRcvdByLenderAmt | Required | Amount, zero or more, up to 2 decimal places |
NotLoanOrigFeeOrCapInterestInd | Required | 1 (yes) or 0 (no) |
CSV template columns: the IRIS Taxpayer Portal upload
The portal takes Form 1098-E as a CSV upload built on the IRS template for the form. The tax year 2025 template has 35 columns (16 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 1098-E 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 | Lender TIN Type | Required | TIN type: EIN, SSN |
| D | Lender Taxpayer ID Number | Required | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| E | Lender Name Type | Required | B (business) or I (individual): B, I |
| F | Lender Business or Entity Name Line 1 | Optional | text; up to 40 characters |
| G | Lender Business or Entity Name Line 2 | Optional | text; up to 40 characters |
| H | Lender First Name | Optional | text; up to 20 characters |
| I | Lender Middle Name | Optional | text; up to 20 characters |
| J | Lender Last Name (Surname) | Optional | text; up to 20 characters |
| K | Lender Suffix | Optional | text; up to 20 characters |
| L | Lender Country | Required | country code (US for United States) |
| M | Lender Address Line 1 | Required | text; up to 35 characters |
| N | Lender Address Line 2 | Optional | text; up to 35 characters |
| O | Lender City/Town | Required | text; up to 40 characters |
| P | Lender State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| Q | Lender ZIP/Postal Code | Required | ZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters |
| R | Lender Phone Type | Optional | D (domestic) or I (international): D, I |
| S | Lender Phone | Optional | phone, 10 digits |
| T | Borrower TIN Type | Optional | TIN type: ATIN, ITIN, SSN, UND |
| U | Borrower Taxpayer ID Number | Optional | TIN with dashes (XX-XXXXXXX or XXX-XX-XXXX) |
| V | Borrower First Name | Required | text; up to 20 characters |
| W | Borrower Middle Name | Optional | text; up to 20 characters |
| X | Borrower Last Name (Surname) | Required | text; up to 20 characters |
| Y | Borrower Suffix | Optional | text; up to 20 characters |
| Z | Borrower Country | Required | country code (US for United States) |
| AA | Borrower Address Line 1 | Required | text; up to 35 characters |
| AB | Borrower Address Line 2 | Optional | text; up to 35 characters |
| AC | Borrower City/Town | Required | text; up to 40 characters |
| AD | Borrower State/Province/Territory | Required | two-letter state (or province, up to 17 characters); up to 17 characters |
| AE | Borrower ZIP/Postal Code | Required | ZIP: exactly 5, 9 or 12 digits for a U.S. address, no dash; up to 9 characters |
| AF | Office Code | Optional | 4 characters |
| AG | Form Account Number | Optional | text; up to 20 characters |
| AH | Box 1 - Interest | Required | amount, no $ or commas |
| AI | Box 2 - Origination Fees | Optional | Y or N |
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.