Skip to content

Count all of Wisconsin's listed income in homestead credit household income - #11176

Merged
hua7450 merged 2 commits into
mainfrom
wi-homestead-income-sources
Nov 20, 2026
Merged

hua7450 merged 2 commits into
mainfrom
wi-homestead-income-sources

Conversation

@DTrim99

@DTrim99 DTrim99 commented Nov 19, 2026

Copy link
Copy Markdown
Collaborator

Part of #10812 (state credit income audit).

What was wrong

wi_homestead_income (Schedule H line 13) started from adjusted gross income and added only tax-exempt interest, nontaxable Social Security, pensions and unemployment compensation, SSI, the state supplement and W-2 (TANF). Wis. Stat. 71.52(6) adds many more amounts "to the extent not included in Wisconsin adjusted gross income", and the 2025 Schedule H instructions (pages 13-14) give each its line. The model left out child support, maintenance outside AGI, county relief, veterans' benefits, nontaxable IRA and 401(k)-type distributions, 401(k) and 403(b) deferrals, deducted IRA and self-employed plan contributions, workers' compensation and the untaxed part of disability (loss of time) insurance.

The eligibility test for a claimant under 62 who isn't disabled counted S corporation income as earned income. Wis. Stat. 71.52(1g) defines earned income as wages and other employee compensation "plus the amount of the claimant's net earnings from self-employment". An S corporation shareholder's distributive share isn't net earnings from self-employment (IRC 1402(a)).

What changes

Household income: new entries in homestead/income/sources.yaml, each cited in the file to its 71.52(6) clause and Schedule H line:

Entry 71.52(6) 2025 Schedule H line (instructions page)
child_support_received "support money" 9i (14): "court ordered support payments received in 2025, including child support"
wi_homestead_nontaxable_alimony (new) "maintenance payments" 9i note (14): post-2018 maintenance "must be included in household income"
general_assistance "cash public assistance", "cash benefits paid by counties under s. 59.53 (21)" 9j (14): "county relief"
veterans_benefits "veterans disability pensions"; "compensation and other cash benefits received from the United States for past or present service in the armed forces" 9d (13), 9h (14)
tax_exempt_retirement_distributions "the gross amount of any pension or annuity" 9d (13): "nontaxable IRA, SEP, SIMPLE, and qualified plan distributions"
traditional_401k_contributions, traditional_403b_contributions "nontaxable deferred compensation" 9e (13): W-2 box 12 codes D and E
traditional_ira_deduction, self_employed_pension_contribution_ald "contributions to individual retirement accounts under section 219 ..., contributions to Keogh plans ... deducted ... shall be added to 'income'" 9f (13)
workers_compensation, tax_exempt_disability_benefits "worker's compensation", "the gross amount of 'loss of time' insurance" 11b (14)
  • Deferrals: only the 401(k) and 403(b) elective deferrals are added, not pre_tax_contributions. That variable also holds pre-tax health premiums, HSA payroll contributions and dependent care benefits, which aren't deferred compensation.
  • Maintenance: wi_homestead_nontaxable_alimony (person level) is alimony_income − taxable_alimony_income, the pattern AZ and ND use. AGI already holds maintenance under a pre-2019 instrument, so maintenance counts once.
  • Child support recorded on the child: new list homestead/income/all_member_sources.yaml holds child_support_received. The formula passes it to tax_unit_non_dep_add as include_dependents, the same mechanism as the federal filer_amounts_recorded_on_dependents, so support counts even when the data puts it on the child. Every other source still counts for the claimant and spouse only (71.52(4)), so a dependent's own workers' compensation, veterans' benefits and the like stay out.
  • New entries go at the end of the list, after tanf, so they don't touch the lines Count railroad benefits in state tax worksheets, income tests and limits as each state's law does #10722 (railroad benefits) inserts after filer_tax_exempt_social_security. The two changes are compatible and should merge without conflict.

Eligibility: homestead/eligible/earnings_sources.yaml. partnership_s_corp_income is replaced by partnership_self_employment_net_earnings (Schedule K-1 box 14), the source the Wisconsin married couple credit already uses. The file now cites 71.52(1g) as well. Definition 4 on page 7 of the instructions reads the same way: "Wages, salaries, tips, other employee compensation, and net earnings from self-employment".

Who is affected

The homestead credit is refundable, so each change moves Wisconsin income tax in the opposite direction from the credit.

  • Household income rises for claimants (and spouses) with any of the listed amounts. Their credit falls, or ends once household income reaches $24,680, and their Wisconsin income tax rises. Child support, veterans' benefits and retirement-plan deferrals likely reach the most claimants.
  • Lost eligibility: claimants under 62 who aren't disabled and whose only "earned income" was S corporation income, or partnership income with no net earnings from self-employment recorded, no longer qualify. Their credit goes to $0 and their tax rises.
  • No one's household income falls. Pre-2019 maintenance was already counted once and still is.

Tests

  • Moved from Audit state credit income definitions against the law (CI run, do not merge) #10812, with the "audit" and "Main:" framing dropped and the arithmetic and citations kept:
    • wi_homestead_income.yaml: audit cases 1-8 become Cases 20, 22, 24, 26, 27, 29, 31 and 32 (child support, untaxed maintenance, workers' compensation, veterans' benefits, IRA contribution, 401(k) deferral, nontaxable IRA distribution, county relief). Expected values are unchanged.
    • wi_homestead_eligible.yaml: the S corporation case becomes Case 16 (expected false).
  • Added:
    • Income: child support recorded on the child (Case 21); pre-2019 maintenance counted once (Case 23); disability benefits where 2,000 is taxable and 1,000 isn't, so household income gets the 3,000 gross once (Case 25); a self-employed SEP contribution, end to end through the self-employment tax deduction (Case 28); a 403(b) deferral (Case 30); a dependent student's own workers' compensation left out (Case 33).
    • Eligibility: a general partner with net earnings from self-employment qualifies (Case 17), and a partner with none recorded doesn't (Case 18). An edge at the $24,680 limit ("less than $24,680", instructions page 4): veterans' benefits leaving household income at 24,679 (eligible, Case 19) and at 24,680 (not eligible, Case 20).
    • Credit: a 70-year-old homeowner with 12,000 of Social Security, 6,000 of veterans' benefits and 1,000 of property tax. Household income is 18,000 and the credit is (1,000 − (18,000 − 8,060) × 8.785%) × 80% = 101.42; on main it is 523.10 (wi_homestead_credit.yaml Case 7).
  • Changed: none. No existing expected value moved.

Not in this PR

Other Wisconsin homestead gaps from the #10812 audit:

  • Audit case 9, Example 1 on page 12 of the instructions (medical care insurance subtraction). Household income starts from Wisconsin AGI, which is net of Wisconsin's medical care insurance subtraction. PolicyEngine starts from federal AGI and doesn't model that subtraction. The case also depends on the example's elected $765 retirement subtraction, so it needs rewriting (review section 3, item 1). This needs the new subtraction and a later PR.
  • Other Wisconsin subtractions in the base: taxable state tax refund, college savings contributions and other Schedule SB subtractions, which the statute doesn't add back.
  • Nontaxable scholarships and fellowships (71.52(6); line 9h) and non-Social Security survivor pensions (line 9d): not listed yet, and the inputs need checking.
  • Railroad retirement benefits (line 9c): open PR Count railroad benefits in state tax worksheets, income tests and limits as each state's law does #10722.
  • Not modelable with current inputs: nontaxable military pay (combat pay, allowances), kinship care and adoption assistance, excluded gain on the sale of a home, depreciation and related add-backs, net operating loss carryforwards, the farmer exception to the disqualified-loss add-back, and repayments other than negative Social Security.

Tested on Modal: run w1-wi-a, 239/239 passed (232 YAML files: the Wisconsin test folder, every partner test and the household state-tax tests that read the credit; and 7 pytest files: the source-conflict guard, parameter keys, reference URLs, the Wisconsin claimable-filer and statutory invariants, the Wisconsin retirement election and household SPM resource parity).

🤖 Generated with Claude Code

…income

Add child support (including amounts recorded on the child), maintenance
outside AGI, county relief, veterans' benefits, nontaxable retirement
distributions, 401(k) and 403(b) deferrals, deducted IRA and self-employed
plan contributions, workers' compensation and the untaxed part of disability
insurance, as Wis. Stat. 71.52(6) and the 2025 Schedule H lines 9d-9j and 11b
require. For the earned income test (71.52(1g)), count a partner's net
earnings from self-employment instead of partnership and S corporation
income.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (8999568) to head (d2f8539).
⚠️ Report is 228 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main    #11176   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         2    +1     
  Lines           24        35   +11     
  Branches         0         1    +1     
=========================================
+ Hits            24        35   +11     
Flag Coverage Δ
unittests 100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

… out of gross income

Covers the fallback in wi_homestead_nontaxable_alimony when federal gross
income doesn't list taxable_alimony_income, which codecov flagged as the
one uncovered patch line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DTrim99
DTrim99 requested a review from hua7450 November 20, 2026 01:14

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. Each new source matches a clause of Wis. Stat. 71.52(6) and a 2025 Schedule H line. None double counts an amount already in AGI: alimony uses the untaxed remainder, and disability and retirement use the tax-exempt part. Counting the claimant and spouse only, plus child support recorded on a dependent, follows 71.52(4)-(5). Using a partner's net earnings from self-employment for the earned-income test matches 71.52(1g). No existing test input changed. Approving.

Optional:

  • The $24,680 boundary. New Case 20 in wi_homestead_eligible.yaml expects exactly 24,680 to be ineligible, citing the instructions' "less than $24,680". 71.54(1)(cm) bars the credit only when income "exceeds $24,680". The credit is 0 either way (8.785% × 16,620 = 1,460.07, above the 1,460 cap). A comment quoting the statute next to the form, or dropping that one assertion, would cover it.
  • Case 23b. It sits between Cases 23 and 24, and it hard-codes a copy of the federal gross income source list that will drift when main adds a source. Renumbering it as the last case and noting where the list came from would fix both. The PR body's test list doesn't mention it.
  • Shared alimony helper (follow-up). wi_homestead_nontaxable_alimony is the fourth copy of alimony_income - taxable_alimony_income, after AZ and ND, and the Montana and Utah PRs in this series add more. One federal person-level variable could replace them all later.

@hua7450
hua7450 merged commit c2a2a00 into main Nov 20, 2026
39 checks passed
@hua7450
hua7450 deleted the wi-homestead-income-sources branch November 20, 2026 19:38
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.

2 participants