Skip to content

Add joint federal and state itemization - #11157

Open
MaxGhenis wants to merge 11 commits into
mainfrom
joint-federal-state-itemization
Open

MaxGhenis wants to merge 11 commits into
mainfrom
joint-federal-state-itemization

Conversation

@MaxGhenis

@MaxGhenis MaxGhenis commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Set gov.simulation.joint_federal_state_itemization to true to choose deductions for a 2025 full-year resident by comparing combined federal, state and local income tax. By default, PolicyEngine chooses the federal deduction under federal rules and applies each state's deduction formula. Callers supply filing facts from a spouse's separate state return or a return in another state when those facts affect the choice.

PolicyEngine tests up to four combinations of federal and state standard or itemized deductions, depending on state law. For example, DC requires the same method on both returns. A single DC resident who earns $150,000 and pays $13,500 in deductible mortgage interest and $2,500 in deductible income taxes would save $60 in federal tax by itemizing. DC tax would rise by $127.50. The resident saves $67.50 overall by taking the standard deduction. DC Act 26-214 · 2025 DC resident return instructions

Maryland lets federal itemizers take either state deduction, and PolicyEngine includes county income tax in the comparison. Nebraska gives federal itemizers the larger allowable state deduction. Maryland resident instructions · Nebraska statute

PolicyEngine also compares the federal Schedule A elections for income and general sales taxes when the choice affects Maryland, Missouri, Nebraska or Virginia tax. Maryland retains eligible sales tax in the federal cap and applies its own itemized-deduction phaseout afterward. Missouri subtracts the income-tax share of the federal deduction and excludes city earnings taxes from that subtraction. Maryland Form 502 instructions · Missouri Schedule MO-A · Nebraska Form 1040N instructions · Virginia Schedule A instructions

For New York itemizers, PolicyEngine compares the college tuition deduction and credit using state and applicable city income tax. It also compares them when the caller explicitly supplies the automatic state method. When a repayment qualifies under section 1341, PolicyEngine carries the credit or deduction from the selected return into the final liability. New York Form IT-272 · IRS Publication 525

Prerequisites

Separate commits cover the state deduction amounts and credits used in the election calculations.

North Carolina gives a married separate filer a zero state standard deduction when their spouse itemizes federally. North Carolina statute

Axiom parity

axiom: TheAxiomFoundation/rulespec-us#2312 queued for North Carolina
axiom: TheAxiomFoundation/rulespec-us#2038 queued for Nebraska
axiom: TheAxiomFoundation/rulespec-us#1999 queued for Maryland
axiom: TheAxiomFoundation/rulespec-us#2002 queued for Missouri

Before merge

We queued independent review for this revision. GitHub is running checks. The national itemizer-count effects and full-population runtime remain unverified.

@MaxGhenis
MaxGhenis marked this pull request as ready for review November 19, 2026 12:07

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant