IRIS CSV upload error troubleshooter
Pick the symptom you see in the IRS IRIS Taxpayer Portal and get the shortest troubleshooting path for that problem.
✓ No tax data is required for this toolBefore changing the data, identify whether the problem is the portal or the CSV
- Start is gray: make sure IRIS actually shows the uploaded filename.
- Add All spins: refresh and check Unsubmitted Forms before uploading again.
- Layout or field error: validate the final CSV against the exact form template.
- Long TIN/ZIP/account values changed: inspect the saved CSV for removed leading zeros or scientific notation.
What problem are you seeing?
Select the symptom that best matches what you see. You can change the selection at any time.
Three tools to use before retrying the portal.
Start with the file itself, then retry IRIS after you have ruled out structural and formatting problems.
Validate the CSV
Compare the final CSV against the expected form layout and catch common hazards.
Open validator →Run the formatting checklist
Review UTF-8 saving, identifiers, dates, header structure, and final-save risks.
Open checklist →Start from the correct template
Open the template library for the form you are preparing.
Browse templates →What the IRS currently tells filers to check
Why does the IRIS Start button stay inactive after I upload a CSV?
The IRS says to confirm the file is saved as CSV and that the file name appears in the blue Current Uploaded File box. If it does not appear, refresh the page and upload again. If it appears and there are no issues, the Start button should become active.
What if IRIS keeps spinning after I choose Add All?
The IRS recommends refreshing the page, returning to the Taxpayer Portal dashboard, and checking the Unsubmitted Forms tile. If the forms were not uploaded, retry the upload before calling the Help Desk.
How many records can a CSV contain?
IRS Publication 5717 (Rev. 2-2026) states that an IRIS CSV file can contain a maximum of 250 records. If your CSV contains more than 250 records, split it into smaller files before upload.
Why can Excel create IRIS errors even if the worksheet looks correct?
Spreadsheet software can reinterpret dates, identifiers and long numbers. Publication 5717 specifically warns about scientific notation and date reformatting and recommends checking the final CSV itself.
Official references: IRS IRIS guidance and helpful hints · Publication 5717 · IRIS known issues and solutions.
Open a form-specific CSV error guide.
Use the exact column count and form-specific field checklist for the file you are preparing.
Want us to take over the filing?
If a CSV problem is blocking a deadline, 1099ERICH can help prepare and validate IRIS-ready files from CSV or Excel data. You remain responsible for submitting the files through your own IRS access.
Need to fix a return after submission?
Use the IRIS Correction Center for accepted-return corrections, rejected-transmission recovery, and form-specific correction guides.
Move from a free check to the complete 1099ERICH workflow.
The free tools help diagnose individual filing problems. 1099ERICH is a Windows desktop workflow with plans starting at $149 for importing CSV or Excel data, validating records, printing recipient copies, and creating IRIS-ready CSV files.
Need more than the free check?
Use this tool to identify the issue, follow the detailed support guide for the filing decision, then return to your controlled source file before creating the final IRIS output.
Need to prepare a less-common information return?
These separate free tools provide form-specific calculations, templates, and structural checks. Their intake spreadsheets are not official IRS upload files.