Updated October 17, 2026. Quick answer: Code Y on Form 8949 is for reporting gain you deferred in an earlier year by investing in a qualified opportunity fund (QOF) and are now recognizing. The instructions say to “Enter code “Y” in column (f), and enter the amount of previously deferred gain as a positive number in column (g).” Each investment gets its own row.
What code Y means
The Form 8949 instructions describe the situation in the code table: “reporting your gain from a QOF investment that you deferred in a prior tax year”. The Schedule D instructions define the fund: “A QOF is any investment vehicle that is organized as either a corporation or partnership for the purpose of investing in eligible property that is located in a qualified opportunity zone.”
Code Y is the later half of a two-step story. The first step, when the gain was deferred, is entered with code Z and is explained on Form 8949 code Z. Code Y is the step where that deferred gain comes into income.
When you report gain with code Y
The trigger is a sale or exchange of the QOF investment. The instructions say “If you sold or exchanged your investment in a QOF during the tax year, you must report the amount of eligible gain that you previously deferred and that you are now recognizing.” The Schedule D instructions describe the outer limit of deferral: “If you have an eligible gain, you can invest that gain in a QOF and elect to defer part or all of the gain that you would otherwise include in income until you sell or exchange the investment in the QOF or December 31, 2026, whichever is earlier.”
The Schedule D instructions also say what to do on page 1 of that form: “If you disposed of any investment in a QOF during the tax year, check the box on page 1 of Schedule D and see the Instructions for Form 8949 for additional reporting requirements.”
What to enter on the code Y row
The instructions give the row, step by step. “Report the gain from each investment on its own row.” “Check box C or box I in Part I or check box F or box L in Part II depending on whether the gain is short term or long term.” “The gain you recognize will be the same character as the gain you deferred.”
For the columns: “Put the EIN of the QOF investment you are selling in column (a).” “Complete columns (b), (c), (d), and (e).” “Enter code “Y” in column (f), and enter the amount of previously deferred gain as a positive number in column (g).” That differs from the deferral row for code Z, where columns (c), (d), and (e) are left blank. The character rule connects to the holding period tests covered on the Form 1099-B box 2 page, and the box choices are laid out in the box A to L guide.
As an illustration, not an IRS example: suppose $40,000 of long-term gain was deferred in an earlier year. On the year of the sale, the code Y row shows $40,000 as a positive number in column (g), not ($40,000), because it brings the deferred gain back in rather than postponing it.
Gains from section 1231 property
A second Y row appears for deferred section 1231 gains. The instructions say “Each inclusion will use two separate rows in Part II.” The first row is a description row: “For the first row, in column (a), write “QOF INCLUSION EVENT FROM SECTION 1231 GAINS.”” It uses code O, covered on Form 8949 code O. On the second row, “Enter code “Y” in column (f), and in column (g) enter the amount of previously deferred gain as a positive number.”
Form 8997 goes with it
The instructions add a reminder: “If you disposed of your investment in a QOF , you will also need to complete Form 8997.” The Schedule D instructions say the same: “You must also complete Part III of Form 8997.”
Setting up the row
Columns (f) and (g) work as a pair. “In order to explain any adjustment to gain (or loss) in column (g), enter the appropriate code(s) in column (f).” The dollar side is described this way: “Enter in this column any necessary adjustments to gain (or loss). Enter negative amounts in parentheses.” Most rows need neither: “For most transactions, you don’t need to complete columns (f) and (g) and can leave them blank.”
If a row needs more than one code, the instructions say “Don’t separate the codes by a space or comma.” They also give the rule for the dollar amount: “If you entered more than one code in column (f) on the same row, enter the net adjustment in column (g).”
Where it goes next
Column (h) is where the adjustment lands. The instructions say “First, subtract the cost or other basis in column (e) from the proceeds (sales price) in column (d). Then take into account any adjustments in column (g). Enter the gain (or loss) in column (h).”
The row then flows to the summary. “The total of the amounts in column (h) of line 2 of all your Forms 8949 should equal the amount you get by combining columns (d), (e), and (g) on the corresponding line of Schedule D (Form 1040).” The Schedule D page explains the lines that total comes from, and the Form 8949 instructions page covers the form as a whole.
Edition and line numbers
This page reads the 2025 Form 8949 and its 2025 instructions, along with the 2025 Instructions for Schedule D (Form 1040) (and Publication 550 for 2025 returns where it is cited), the current files irs.gov served on 2026-10-17. They are the forms for the tax year 2025 return, filed in 2026. Check the tax year printed on the form you are filling in and use the column letters and codes on that year’s form, because a different year’s form can letter its columns or word its codes differently.
Common mistakes
- Entering the deferred gain as a negative number. The instructions say to enter “the amount of previously deferred gain as a positive number in column (g).”
- Leaving the sale columns blank. For code Y the instructions say “Complete columns (b), (c), (d), and (e).” Blank sale columns belong to the code Z deferral row. The ordinary code Y row completes them; the one exception is the second code Y row for section 1231 gains, where columns (d) and (e) are left blank.
- Combining several QOF investments on one row. The instructions say “Report the gain from each investment on its own row.”
Related: Form 8949 code Z, Form 1099-B box 2, Form 1099-DA box 6, Form 8949 instructions, and Schedule D.
Sources
- Instructions for Form 8949 (2025): https://www.irs.gov/pub/irs-pdf/i8949.pdf
- Instructions for Schedule D (Form 1040) (2025): https://www.irs.gov/pub/irs-pdf/i1040sd.pdf
Read from the IRS documents linked above on October 17, 2026. General information, not tax advice. Your own facts decide the outcome, and a preparer, the account provider or the IRS is the right place to confirm anything consequential.