Qualified Principal Residence Indebtedness (QPRI)

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.

Key Takeaways

  • The debt must be secured by the taxpayer’s one main home.
  • Proceeds must generally have been used to acquire, construct, reconstruct, or substantially improve that home.
  • Cash-out proceeds used for cards, tuition, vehicles, travel, or other personal costs generally do not become QPRI merely because the home secures the loan.
  • A refinancing preserves QPRI only to the extent it replaces qualifying principal, plus qualifying improvement debt under the applicable rules.
  • For debt after 2020 and before 2026, the maximum debt treated as QPRI is $750,000, or $375,000 for married filing separately.
  • Nonqualified debt is treated first under the cancellation ordering rule.
  • Form 982 is generally required to claim the exclusion, and a borrower who keeps the home generally reduces its basis by the excluded QPRI amount.

Current Availability of the Exclusion

Cancellation timingGeneral federal QPRI treatment under current guidance
Debt discharged before January 1, 2026May 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, 2026May qualify under the transition rule
Debt discharged after 2025 with no qualifying pre-2026 written arrangementQPRI 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.

Qualification Test

1. Main home

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.

2. Secured debt

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.

3. Acquisition or improvement use

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.

4. Cost and debt limits

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.

5. Cause of cancellation

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 and Cash-Out Debt

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 proceedsGeneral QPRI direction
Pay off qualifying acquisition mortgageQualifies up to the old qualifying principal
Build a qualifying addition to the same main homeCan qualify subject to documentation and limits
Pay credit-card balancesGenerally nonqualified
Pay tuition or medical costsGenerally nonqualified
Buy a vehicle or investmentGenerally nonqualified
Improve a different propertyGenerally 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.

Cancellation Ordering Rule

When a loan contains both QPRI and nonqualified debt, the federal ordering rule treats the nonqualified portion as canceled first. A simplified expression is:

$$ \text{Potential QPRI Cancellation} = \max(0,\ \text{Total Debt Canceled} - \text{Nonqualified Debt Before Cancellation}) $$

The result remains subject to the QPRI cap, timing rule, cause requirement, and any other applicable limits.

Worked Example: Mixed Refinance Debt

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
  • the lender cancels $100,000 under a qualifying written modification.

Under the ordering rule, the $60,000 nonqualified portion is treated as canceled first:

$$ \text{Potential QPRI Cancellation} = \$100{,}000 - \$60{,}000 = \$40{,}000 $$

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.

Foreclosure, Short Sale, and Loan Modification

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:

  1. Was debt canceled, and how much?
  2. Was the debt recourse or nonrecourse?
  3. What amount is realized on the property’s disposition?
  4. What was the home’s adjusted basis?
  5. How much canceled debt is QPRI after tracing and ordering?
  6. Does the timing or written-arrangement rule permit the exclusion?
  7. Does another exclusion apply to any remaining canceled debt?

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.

Form 1099-C and Form 982

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.

QPRI vs. Other Exclusions

ExclusionMain testGeneral attribute consequence
Title 11 bankruptcyDebt discharged in a qualifying bankruptcy caseTax attributes generally reduced under bankruptcy rules
InsolvencyLiabilities exceed fair market value of assets immediately before cancellationExclusion limited to insolvency amount; tax attributes generally reduced
QPRIQualifying main-home debt and statutory timing requirementsBasis of retained principal residence generally reduced
Qualified real-property business debtQualifying business real-estate debt and electionBasis 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.

Documentation Checklist

  • Original purchase closing statement.
  • Construction and substantial-improvement invoices.
  • Original mortgage and security instrument.
  • Refinancing statements and old principal payoff amount.
  • Trace of every cash-out disbursement.
  • Written cancellation or modification agreement and its execution date.
  • Form 1099-C and, where applicable, Form 1099-A.
  • Fair market value support and recourse-status documents.
  • Home basis schedule and prior improvements.
  • Bankruptcy or insolvency records if another exclusion may apply.

Common Mistakes

  • Using the expired $2 million limit for a post-2020 cancellation.
  • Assuming the QPRI exclusion automatically applies to new cancellations after 2025.
  • Treating a verbal negotiation as a qualifying pre-2026 written arrangement.
  • Classifying all cash-out refinance debt as acquisition debt.
  • Ignoring the rule that nonqualified debt is canceled first.
  • Applying QPRI to a second home or rental property.
  • Treating a short sale as stock-market short selling.
  • Reporting the Form 1099-C amount without a separate disposition calculation.
  • Excluding QPRI but failing to file Form 982 or reduce retained-home basis.

Risks and Limitations

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.

Authoritative Sources

  • Debt Forgiveness: Cancellation of an enforceable repayment obligation.
  • Insolvency: Alternative exclusion based on liabilities exceeding asset fair market value.
  • Discharge in Bankruptcy: Court-ordered release analyzed under the bankruptcy exclusion.
  • Adjusted Tax Basis: Tax investment used in the home disposition and possible basis-reduction calculations.
  • Loan Modification: Change to mortgage terms that can include principal cancellation.

FAQs

Is the QPRI exclusion available for debt canceled in 2026?

Generally only when the cancellation occurs under an arrangement entered into and evidenced in writing before January 1, 2026. A new post-2025 arrangement generally cannot use the exclusion under current federal law.

What is the current QPRI debt limit for the final exclusion period?

For debt after 2020 and before 2026, IRS guidance states a maximum of $750,000, or $375,000 for married filing separately. The qualifying canceled amount can be lower after tracing, ordering, and other limits.

Does cash-out refinance debt qualify as QPRI?

Only the portion that refinances qualifying principal or independently finances a substantial improvement to the same main home can qualify. Proceeds used for unrelated personal expenses generally do not.

Can insolvency apply when QPRI does not?

Possibly. Insolvency is a separate exclusion measured immediately before cancellation. It has its own limits, Form 982 treatment, and tax-attribute reductions.

This article provides general U.S. financial education. It is not individualized tax, legal, mortgage, foreclosure, debt-relief, or investment advice.

Browse Taxation