TIN ComplianceA resource from TIN Comply
IRIS form rules

IRIS Form 1099-DIV: rules and XML elements

What IRIS checks on Form 1099-DIV, Dividends and Distributions: 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 Form1099DIVDetail in the tax year 2026 XML record.

Submission group 1XML element Form1099DIVDetailElements 30, 7 required

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

Copy A of Form 1099-DIV, 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-DIV 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 name, street address, city or town, state or province, country, ZIPIRIS elementIRSubmission1Header/IssuerDetail: BusinessName/BusinessNameLine1Txt or PersonName, MailingAddressGrp (USAddress or ForeignAddress), PhoneNumRequiredRequired in the headerPub 1220 (FIRE)A record 12-20 (TIN), 53-132 (name), 134-224 (address), 225-239 (phone)CSV templatePayer TIN Type
Payer Taxpayer ID Number
Payer 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
Payer Country
Payer Address Line 1
Payer Address Line 2
Payer City/Town
Payer State/Province/Territory
Payer ZIP/Postal Code
Payer Phone Type
Payer Phone
Click to open row 3 in the field map
Box 4: 1a Total ordinary dividendsIRIS elementTotalOrdinaryDividendsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 1, B record 55-66CSV templateBox 1a - Total ordinary dividendsClick to open row 4 in the field mapBox 5: 1b Qualified dividendsIRIS elementQualifiedDividendsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 2, B record 67-78CSV templateBox 1b - Qualified dividendsClick to open row 5 in the field mapBox 6: For calendar yearIRIS elementTaxYr (also IRSubmission1Header/TaxYr and the manifest)RequiredRequired, four-digit yearPub 1220 (FIRE)B record 2-5CSV templateTax YearClick to open row 6 in the field mapBox 7: 2a Total capital gain distr.IRIS elementTotalCapitalDistributionsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 3, B record 79-90CSV templateBox 2a - Total capital gain distributionClick to open row 7 in the field mapBox 8: 2b Unrecap. Sec. 1250 gainIRIS elementUnrecapturedSection1250GainAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 6, B record 115-126CSV templateBox 2b - Unrecap. Sec. 1250 gainClick to open row 8 in the field mapBox 9: PAYER'S TINIRIS elementIRSubmission1Header/IssuerDetail/TIN 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 9 in the field map
Box 10: RECIPIENT'S TINIRIS elementRecipientDetail/TIN with RecipientDetail/TINSubmittedTypeCdRequiredRequired, 9 digits, no dashesPub 1220 (FIRE)B record 12-20; TIN type 11CSV templateRecipient TIN Type
Recipient Taxpayer ID Number
Click to open row 10 in the field map
Box 11: 2c Section 1202 gainIRIS elementCapitalGainSect1202AmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 7, B record 127-138CSV templateBox 2c - Section 1202 gainClick to open row 11 in the field mapBox 12: 2d Collectibles (28%) gainIRIS elementCollectibles28PercentGainAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 8, B record 139-150CSV templateBox 2d - Collectibles (28%) gainClick to open row 12 in the field mapBox 13: 2e Section 897 ordinary dividendsIRIS elementSection897OrdinaryDividendsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code H, B record 247-258CSV templateBox 2e - Section 897 ordinary dividendsClick to open row 13 in the field mapBox 14: 2f Section 897 capital gainIRIS elementSection897CapitalGainAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code J, B record 259-270CSV templateBox 2f - Section 897 capital gainClick to open row 14 in the field mapBox 15: RECIPIENT'S nameIRIS elementRecipientDetail/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 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 15 in the field map
Box 16: 3 Nondividend distributionsIRIS elementNondividendDistributionsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 9, B record 151-162CSV templateBox 3 - Nondividend distributionsClick to open row 16 in the field mapBox 17: 4 Federal income tax withheldIRIS elementFederalIncomeTaxWithheldAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code A, B record 163-174CSV templateBox 4 - Federal income tax withheldClick to open row 17 in the field mapBox 18: 5 Section 199A dividendsIRIS elementSection199ADividendsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code 5, B record 103-114CSV templateBox 5 - Section 199A dividendsClick to open row 18 in the field mapBox 19: 6 Investment expensesIRIS elementInvestmentExpenseAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code B, B record 175-186CSV templateBox 6 - Investment expensesClick to open row 19 in the field mapBox 20: Street address (including apt. no.)IRIS elementRecipientDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredRequiredPub 1220 (FIRE)B record 368-407CSV templateRecipient Address Line 1Click to open row 20 in the field mapBox 21: 7 Foreign tax paidIRIS elementForeignTaxesPaidAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code C, B record 187-198CSV templateBox 7 - Foreign tax paidClick to open row 21 in the field mapBox 22: 8 Foreign country or U.S. possessionIRIS elementForeignCountryOrUSPossessionCdRequiredOptional, IRS country codePub 1220 (FIRE)B record 547-586CSV templateBox 8 - Foreign country or U.S. possessionClick to open row 22 in the field mapBox 23: City or town, state or province, country, and ZIP or foreign postal codeIRIS elementRecipientDetail/MailingAddressGrp/USAddress: CityNm, StateAbbreviationCd, ZIPCd (ForeignAddress: CityNm, ProvinceOrStateNm, CountryCd, ForeignPostalCd)RequiredRequiredPub 1220 (FIRE)B record 448-487, 488-489, 490-498CSV templateRecipient Country
Recipient City/Town
Recipient State/Province/Territory
Recipient ZIP/Postal Code
Click to open row 23 in the field map
Box 24: 9 Cash liquidation distributionsIRIS elementCashLiquidationDistriAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code D, B record 199-210CSV templateBox 9 - Cash liquidation distributionsClick to open row 24 in the field mapBox 25: 10 Noncash liquidation distributionsIRIS elementNoncashLiquidationDistriAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code E, B record 211-222CSV templateBox 10 - Noncash liquidation distributionsClick to open row 25 in the field mapBox 26: 11 FATCA filingIRIS elementFATCAFilingRequirementIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 587CSV templateFATCA Filing RequirementsClick to open row 26 in the field mapBox 27: 12 Exempt-interest dividendsIRIS elementExemptInterestDividendsAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code F, B record 223-234CSV templateBox 12 - Exempt-interest dividendsClick to open row 27 in the field mapBox 28: 13 Specified private activityIRIS elementPrivateActivityBondIntDivAmtRequiredOptional, amount, 2 decimalsPub 1220 (FIRE)Amount code G, B record 235-246CSV templateBox 13 - Specified private activity bond interest dividendsClick to open row 28 in the field mapBox 29: Account number (see instructions)IRIS elementRecipientAccountNumRequiredOptional, up to 30 charactersPub 1220 (FIRE)B record 21-40CSV templateForm Account NumberClick to open row 29 in the field mapBox 30: 2nd TIN not.IRIS elementSecondTINNoticeIndRequiredRequired, 1 or 0Pub 1220 (FIRE)B record 544CSV template2nd TIN NoticeClick to open row 30 in the field mapBox 31: 14 StateIRIS elementStateLocalTaxGrp/StateAbbreviationCdRequiredOptional, two-letter state codePub 1220 (FIRE)B record 747-748 (two-digit CF/SF code in FIRE)CSV templateState 1
State 2
Click to open row 31 in the field map
Box 32: 15 State identification no.IRIS elementStateLocalTaxGrp/StateTaxGrp/StateIdNumRequiredOptionalPub 1220 (FIRE)B record 663-722 (special data entries, where the form instructions put it)CSV templateState 1 - State/Payer state number
State 2 - State/Payer state number
Click to open row 32 in the field map
Box 33: 16 State tax withheldIRIS elementStateLocalTaxGrp/StateTaxGrp/StateTaxWithheldAmtRequiredOptional, amountPub 1220 (FIRE)B record 723-734CSV templateState 1 - State tax withheld
State 2 - State tax withheld
Click to open row 33 in the field map
Form 1099-DIV, 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 Form1099DIVDetail 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 name, street address, city or town, state or province, country, ZIPIRSubmission1Header/IssuerDetail: BusinessName/BusinessNameLine1TxtorPersonName, MailingAddressGrp, PhoneNumRequiredin the headerA record 12-20 (TIN), 53-132 (name), 134-224 (address), 225-239 (phone)Payer TIN TypePayer Taxpayer ID NumberPayer Name Type
and 14 more columnsPayer Business or Entity Name Line 1Payer Business or Entity Name Line 2Payer First NamePayer Middle NamePayer Last Name (Surname)Payer SuffixPayer CountryPayer Address Line 1Payer Address Line 2Payer City/TownPayer State/Province/TerritoryPayer ZIP/Postal CodePayer Phone TypePayer Phone
41a Total ordinary dividendsTotalOrdinaryDividendsAmtOptionalAmount, 2 decimalsAmount code 1, B record 55-66Box 1a - Total ordinary dividends
51b Qualified dividendsQualifiedDividendsAmtOptionalAmount, 2 decimalsAmount code 2, B record 67-78Box 1b - Qualified dividends
6For calendar yearTaxYrAlso in IRSubmission1Header/TaxYr and the manifestRequiredFour-digit yearB record 2-5Tax Year
72a Total capital gain distr.TotalCapitalDistributionsAmtOptionalAmount, 2 decimalsAmount code 3, B record 79-90Box 2a - Total capital gain distribution
82b Unrecap. Sec. 1250 gainUnrecapturedSection1250GainAmtOptionalAmount, 2 decimalsAmount code 6, B record 115-126Box 2b - Unrecap. Sec. 1250 gain
9PAYER'S TINIRSubmission1Header/IssuerDetail/TIN with TINSubmittedTypeCd (BUSINESS_TIN, INDIVIDUAL_TIN, UNKNOWN)Required9 digitsA record 12-20Payer TIN TypePayer Taxpayer ID Number
10RECIPIENT'S TINRecipientDetail/TIN with RecipientDetail/TINSubmittedTypeCdRequired9 digits, no dashesB record 12-20; TIN type 11Recipient TIN TypeRecipient Taxpayer ID Number
112c Section 1202 gainCapitalGainSect1202AmtOptionalAmount, 2 decimalsAmount code 7, B record 127-138Box 2c - Section 1202 gain
122d Collectibles (28%) gainCollectibles28PercentGainAmtOptionalAmount, 2 decimalsAmount code 8, B record 139-150Box 2d - Collectibles (28%) gain
132e Section 897 ordinary dividendsSection897OrdinaryDividendsAmtOptionalAmount, 2 decimalsAmount code H, B record 247-258Box 2e - Section 897 ordinary dividends
142f Section 897 capital gainSection897CapitalGainAmtOptionalAmount, 2 decimalsAmount code J, B record 259-270Box 2f - Section 897 capital gain
15RECIPIENT'S nameRecipientDetail/PersonNameorRecipientDetail/BusinessName/BusinessNameLine1TxtName 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
163 Nondividend distributionsNondividendDistributionsAmtOptionalAmount, 2 decimalsAmount code 9, B record 151-162Box 3 - Nondividend distributions
174 Federal income tax withheldFederalIncomeTaxWithheldAmtOptionalAmount, 2 decimalsAmount code A, B record 163-174Box 4 - Federal income tax withheld
185 Section 199A dividendsSection199ADividendsAmtOptionalAmount, 2 decimalsAmount code 5, B record 103-114Box 5 - Section 199A dividends
196 Investment expensesInvestmentExpenseAmtOptionalAmount, 2 decimalsAmount code B, B record 175-186Box 6 - Investment expenses
20Street address (including apt. no.)RecipientDetail/MailingAddressGrp/USAddress/AddressLine1TxtRequiredB record 368-407Recipient Address Line 1
217 Foreign tax paidForeignTaxesPaidAmtOptionalAmount, 2 decimalsAmount code C, B record 187-198Box 7 - Foreign tax paid
228 Foreign country or U.S. possessionForeignCountryOrUSPossessionCdOptionalIRS country codeB record 547-586Box 8 - Foreign country or U.S. possession
23City or town, state or province, country, and ZIP or foreign postal codeRecipientDetail/MailingAddressGrp/USAddress: CityNm, StateAbbreviationCd, ZIPCd (or ForeignAddress)RequiredB record 448-487, 488-489, 490-498Recipient CountryRecipient City/TownRecipient State/Province/TerritoryRecipient ZIP/Postal Code
249 Cash liquidation distributionsCashLiquidationDistriAmtOptionalAmount, 2 decimalsAmount code D, B record 199-210Box 9 - Cash liquidation distributions
2510 Noncash liquidation distributionsNoncashLiquidationDistriAmtOptionalAmount, 2 decimalsAmount code E, B record 211-222Box 10 - Noncash liquidation distributions
2611 FATCA filingFATCAFilingRequirementIndRequired1 or 0B record 587FATCA Filing Requirements
2712 Exempt-interest dividendsExemptInterestDividendsAmtOptionalAmount, 2 decimalsAmount code F, B record 223-234Box 12 - Exempt-interest dividends
2813 Specified private activityPrivateActivityBondIntDivAmtOptionalAmount, 2 decimalsAmount code G, B record 235-246Box 13 - Specified private activity bond interest dividends
29Account number (see instructions)RecipientAccountNumOptionalUp to 30 charactersB record 21-40Form Account Number
302nd TIN not.SecondTINNoticeIndRequired1 or 0B record 5442nd TIN Notice
3114 StateStateLocalTaxGrp/StateAbbreviationCdOptionalTwo-letter state codeB record 747-748 (two-digit CF/SF code in FIRE)State 1State 2
3215 State identification no.StateLocalTaxGrp/StateTaxGrp/StateIdNumOptionalB record 663-722 (special data entries, where the form instructions put it)State 1 - State/Payer state numberState 2 - State/Payer state number
3316 State tax withheldStateLocalTaxGrp/StateTaxGrp/StateTaxWithheldAmtOptionalAmountB record 723-734State 1 - State tax withheldState 2 - State tax withheld

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, Form1099DIVDetail (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-DIV business rules

Form 1099-DIV 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
F1099DIV001Report error, reject over thresholdTotal ordinary dividends cannot be less than qualified dividends, section 897 ordinary dividends, investment expenses and section 199A dividends combined.
F1099DIV002Report error, reject over thresholdIf qualified dividends are reported, total ordinary dividends are required.
F1099DIV003_001Report error, reject over thresholdTotal capital gain distributions must be at least the unrecaptured section 1250 gain, section 1202 gain, collectibles (28%) gain and section 897 capital gain combined.
F1099DIV004Report error, reject over thresholdFederal income tax withheld looks too high compared with the income amounts reported on the form.
F1099DIV005Report error, reject over thresholdExempt-interest dividends cannot be less than the specified private activity bond interest dividends.

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 Form1099DIVDetail, in schema order

IRTransmission › IRSubmission1Grp › IRSubmission1Detail › Form1099DIVDetail

Each Form 1099-DIV return is one Form1099DIVDetail 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
FATCAFilingRequirementIndRequired1 (yes) or 0 (no)
SecondTINNoticeIndRequired1 (yes) or 0 (no)
TotalOrdinaryDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
QualifiedDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
TotalCapitalDistributionsAmtOptionalAmount, zero or more, up to 2 decimal places
UnrecapturedSection1250GainAmtOptionalAmount, zero or more, up to 2 decimal places
CapitalGainSect1202AmtOptionalAmount, zero or more, up to 2 decimal places
Collectibles28PercentGainAmtOptionalAmount, zero or more, up to 2 decimal places
Section897OrdinaryDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
Section897CapitalGainAmtOptionalAmount, zero or more, up to 2 decimal places
NondividendDistributionsAmtOptionalAmount, zero or more, up to 2 decimal places
FederalIncomeTaxWithheldAmtOptionalAmount, zero or more, up to 2 decimal places
Section199ADividendsAmtOptionalAmount, zero or more, up to 2 decimal places
InvestmentExpenseAmtOptionalAmount, zero or more, up to 2 decimal places
ForeignTaxesPaidAmtOptionalAmount, zero or more, up to 2 decimal places
ForeignCountryOrUSPossessionCdOptionalIRS two-letter country code
CashLiquidationDistriAmtOptionalAmount, zero or more, up to 2 decimal places
NoncashLiquidationDistriAmtOptionalAmount, zero or more, up to 2 decimal places
ExemptInterestDividendsAmtOptionalAmount, zero or more, up to 2 decimal places
PrivateActivityBondIntDivAmtOptionalAmount, zero or more, up to 2 decimal places
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-DIV as a CSV upload built on the IRS template for the form. The tax year 2025 template has 69 columns (17 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-DIV 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
AL2nd TIN NoticeOptionalY or N
AMBox 1a - Total ordinary dividendsOptionalamount, no $ or commas
ANBox 1b - Qualified dividendsOptionalamount, no $ or commas
AOBox 2a - Total capital gain distributionOptionalamount, no $ or commas
APBox 2b - Unrecap. Sec. 1250 gainOptionalamount, no $ or commas
AQBox 2c - Section 1202 gainOptionalamount, no $ or commas
ARBox 2d - Collectibles (28%) gainOptionalamount, no $ or commas
ASBox 2e - Section 897 ordinary dividendsOptionalamount, no $ or commas
ATBox 2f - Section 897 capital gainOptionalamount, no $ or commas
AUBox 3 - Nondividend distributionsOptionalamount, no $ or commas
AVBox 4 - Federal income tax withheldOptionalamount, no $ or commas
AWBox 5 - Section 199A dividendsOptionalamount, no $ or commas
AXBox 6 - Investment expensesOptionalamount, no $ or commas
AYBox 7 - Foreign tax paidOptionalamount, no $ or commas
AZBox 8 - Foreign country or U.S. possessionOptionalcountry code (US for United States)
BABox 9 - Cash liquidation distributionsOptionalamount, no $ or commas
BBBox 10 - Noncash liquidation distributionsOptionalamount, no $ or commas
BCBox 12 - Exempt-interest dividendsOptionalamount, no $ or commas
BDBox 13 - Specified private activity bond interest dividendsOptionalamount, no $ or commas
BECombined Federal/State FilingOptionalstate codes separated by commas, in quotes
BFState 1Optionaltwo-letter state (or province, up to 17 characters)
BGState 1 - State tax withheldOptionalamount, no $ or commas
BHState 1 - State/Payer state numberOptionaltext; up to 24 characters
BIState 1 - State incomeOptionalamount, no $ or commas
BJState 1 - Local income tax withheldOptionalamount, no $ or commas
BKState 1 - Special Data EntriesOptionaltext; up to 60 characters
BLState 2Optionaltwo-letter state (or province, up to 17 characters)
BMState 2 - State tax withheldOptionalamount, no $ or commas
BNState 2 - State/Payer state numberOptionaltext; up to 24 characters
BOState 2 - State incomeOptionalamount, no $ or commas
BPState 2 - Local income tax withheldOptionalamount, no $ or commas
BQState 2 - Special Data EntriesOptionaltext; up to 60 characters