These are errors and rejects every filer can get when sending information returns to IRIS, whether through the free IRIS Taxpayer Portal or through filing software. IRIS reports each one on the acknowledgment by rule number.
Form W-2G business rules
Besides the rules on this page, IRIS checks the rules every form shares, such as SHAREDIRFORM014 (payee name and TIN); those are on the cross-form error code pages. The IRIS Taxpayer Portal also takes Form W-2G as a CSV upload, using the IRS template for the form.
In the tax year 2026 rule set: 1 report error and reject over the threshold. A reject stops the submission; a report error is accepted with errors and counts as filed; past an unpublished threshold, report errors reject the submission. The descriptions are our own summaries; your acknowledgment gives the rule number.
| Rule | Severity | What it checks |
|---|---|---|
| FW2G001 | Report error, reject over threshold | Federal income tax withheld looks too high compared with the income amounts reported on the form. |
Elements of FormW2GDetail
Each Form W-2G return is one FormW2GDetail record in a submission of group 1. The table lists its 20 elements in schema order for tax year 2026: 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 |
RecipientDetail | Required | Group of elements |
RecipientAccountNum | Optional | Text, up to 30 characters |
GamblingReportableWinningAmt | Optional | Amount, zero or more, up to 2 decimal places |
GamblingWinningDt | Required | Date, YYYY-MM-DD |
GamblingWinWagerTypeCd | Required | Code from a list of 9 values |
FederalIncomeTaxWithheldAmt | Optional | Amount, zero or more, up to 2 decimal places |
GamblingWinningTransactionDesc | Optional | Text, up to 20 characters |
GamblingWinningEventDesc | Optional | Text, up to 20 characters |
GamblingWinFromIdntclWagersAmt | Optional | Amount, zero or more, up to 2 decimal places |
GamblingWinCashierId | Optional | Text, up to 20 characters |
GamblingWinWindowNum | Optional | Text, up to 20 characters |
RecipientFirstAdditionalIdNum | Optional | Text, up to 40 characters |
RecipientSecondAdditionalIdNum | Optional | Text, up to 40 characters |
StateLocalTaxGrp | Optional, repeats | Group of elements |
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.