Qualified principal residence indebtedness is acquisition debt secured by a main home that can receive time-limited canceled-debt treatment under U.S. federal law.
Qualified principal residence indebtedness (QPRI) is mortgage debt secured by a taxpayer’s main home and used to buy, build, or substantially improve that home. Refinancing debt can qualify, but generally only up to the qualifying principal refinanced.
QPRI is best understood as a debt classification tied to a temporary federal cancellation-of-debt exclusion. Under current IRS guidance, the exclusion generally applies to debt discharged before January 1, 2026, or discharged later under an arrangement entered into and evidenced in writing before that date. A new post-2025 cancellation without a qualifying pre-2026 written arrangement generally cannot use the QPRI exclusion under current law.
$750,000, or $375,000 for married filing separately.| Cancellation timing | General federal QPRI treatment under current guidance |
|---|---|
| Debt discharged before January 1, 2026 | May qualify if all debt, residence, cause, limit, and reporting requirements are met |
| Debt discharged after 2025 under an arrangement entered into and evidenced in writing before January 1, 2026 | May qualify under the transition rule |
| Debt discharged after 2025 with no qualifying pre-2026 written arrangement | QPRI exclusion generally unavailable under current law |
The cancellation date and written arrangement are therefore essential evidence. An application, negotiation, hardship request, or oral discussion may not satisfy a requirement for an arrangement entered into and evidenced in writing.
Even when QPRI is unavailable, bankruptcy, insolvency, or another cancellation-of-debt rule may apply. Those alternatives have separate eligibility, ordering, and tax-attribute consequences.
The property must be the taxpayer’s principal residence, generally the home where the taxpayer ordinarily lives most of the time. A taxpayer can have only one main home at a time for this purpose.
A second home, vacation property, or rental property does not qualify merely because it is residential. Business or rental real estate may require analysis under the qualified real-property business-debt rules instead.
The mortgage must be secured by the main home. An unsecured personal loan used for renovations is not QPRI even if the proceeds improved the residence.
Qualifying debt generally finances the acquisition, construction, reconstruction, or substantial improvement of the same main home securing the debt. Loan labels do not control. A home-equity loan can qualify when proceeds substantially improve that home, while part of a first-lien cash-out refinance can be nonqualified when proceeds pay unrelated personal costs.
QPRI cannot exceed the cost of the principal residence plus qualifying improvements. For the post-2020/pre-2026 exclusion period, current IRS guidance limits QPRI to $750,000, or $375,000 for married filing separately.
These amounts describe the maximum debt that can receive QPRI treatment. The actual exclusion is also limited by the qualifying canceled amount and the ordering rule.
The exclusion does not apply when cancellation is for services performed for the lender or because of another factor not directly related to a decline in the home’s value or the taxpayer’s financial condition.
Refinancing qualifying acquisition debt generally preserves QPRI only up to the old qualifying principal immediately before refinancing. Additional proceeds must independently satisfy the substantial-improvement rule to qualify.
| Use of refinance proceeds | General QPRI direction |
|---|---|
| Pay off qualifying acquisition mortgage | Qualifies up to the old qualifying principal |
| Build a qualifying addition to the same main home | Can qualify subject to documentation and limits |
| Pay credit-card balances | Generally nonqualified |
| Pay tuition or medical costs | Generally nonqualified |
| Buy a vehicle or investment | Generally nonqualified |
| Improve a different property | Generally nonqualified for this home’s QPRI calculation |
Mixed-use loans require proceeds tracing. Do not classify the entire balance from the collateral or product name alone.
When a loan contains both QPRI and nonqualified debt, the federal ordering rule treats the nonqualified portion as canceled first. A simplified expression is:
The result remains subject to the QPRI cap, timing rule, cause requirement, and any other applicable limits.
Assume a homeowner refinanced acquisition debt and later has $360,000 outstanding immediately before a 2025 modification:
$300,000 is qualifying acquisition or improvement debt;$60,000 is cash-out debt used for personal expenses; and$100,000 under a qualifying written modification.Under the ordering rule, the $60,000 nonqualified portion is treated as canceled first:
Up to $40,000 may qualify for the QPRI exclusion, subject to all other requirements. The remaining $60,000 is not excluded under QPRI, though the insolvency or another rule could apply.
If the borrower continues to own the home and excludes $40,000 as QPRI, the borrower generally reports the exclusion on Form 982 and reduces the home’s basis, but not below zero, by the excluded amount.
QPRI can arise through a Foreclosure, short sale, deed transfer, or principal-reduction modification. The event label does not establish the exclusion.
For a foreclosure or short sale, separate these questions:
The property disposition can create gain or loss separately from cancellation-of-debt income. The home-sale exclusion may affect recognized gain but does not itself exclude canceled-debt income.
A lender may issue Form 1099-C showing the canceled amount, event date, liability status, and property value. Box 2 is not automatically the QPRI amount because the loan can include interest or nonqualified principal.
To claim the QPRI exclusion, a taxpayer generally attaches Form 982, checks the QPRI box, and reports the qualifying excluded amount. If the taxpayer continues to own the residence, Form 982 also reports the required basis reduction.
Forms, lines, and rules can change. Use the forms and instructions for the cancellation year.
| Exclusion | Main test | General attribute consequence |
|---|---|---|
| Title 11 bankruptcy | Debt discharged in a qualifying bankruptcy case | Tax attributes generally reduced under bankruptcy rules |
| Insolvency | Liabilities exceed fair market value of assets immediately before cancellation | Exclusion limited to insolvency amount; tax attributes generally reduced |
| QPRI | Qualifying main-home debt and statutory timing requirements | Basis of retained principal residence generally reduced |
| Qualified real-property business debt | Qualifying business real-estate debt and election | Basis in depreciable real property generally reduced |
A cancellation in a Title 11 case uses the bankruptcy exclusion rather than QPRI. A taxpayer who is insolvent outside bankruptcy can elect to use the insolvency exclusion instead of QPRI. The choice can change which attributes are reduced and may require professional analysis.
$2 million limit for a post-2020 cancellation.QPRI is unusually date-sensitive. Future legislation or IRS guidance could change the exclusion period, and state tax law may not conform to the federal result. Loan tracing, home status, written-arrangement evidence, recourse law, and basis can materially change the calculation.
This page explains the federal framework and the current post-2025 boundary. It does not determine eligibility for a particular cancellation, foreclosure, or tax return.
$750,000, or $375,000 for married filing separately. The qualifying canceled amount can be lower after tracing, ordering, and other limits.This article provides general U.S. financial education. It is not individualized tax, legal, mortgage, foreclosure, debt-relief, or investment advice.