QuantCalc QuantCalc State tax engine docs

State tax docs / States / Wisconsin

Wisconsin state income tax: engine rules, 2026

How the QuantCalc engine computes Wisconsin tax for tax year 2026, rule by rule, with the official source for each rule. Verification status: Worksheet-tested (what this means).

On this page: How the tax is computed · Rate schedule · Deductions, exemptions and credits · Age 65+ subtractions and credits · Social Security · IRA, 401(k) and private pensions · Public pensions · Military retirement pay · Wages · Roth conversions · Capital gains · Worked examples · Not calculated · Verification. Machine-readable: this state's entry in the engine config and the provenance file (key WI).

How the tax is computed

Every step the engine takes for Wisconsin, in the order it takes them. Steps marked with a filing status or household type apply only there. Each step links the section below that carries Wisconsin's figures and the official sources for it; the calculation order page describes every step for all jurisdictions.

What each filing status gets, read back from the engine for a household with $1 of income (so below every phase-out and income test):

SingleMarried filing jointlyMarried filing separatelyHead of household
Rate schedule usedsingle schedulejoint scheduleown separate schedulesingle schedule
Top rate7.65% from $332,7207.65% from $443,6307.65% from $221,8207.65% from $332,720
Standard deduction, under 65$13,960$25,840$12,280$18,030
Standard deduction at 70 (joint: both 70)$13,960$25,840$12,280$18,030
Personal exemption$700$1,400$700$700
Age subtractions at 70 (joint: both 70)$250$500$250$250
  1. Per-person mode joint returns with the spouse's age given On a joint return with the spouse's age given, every age test the state applies per taxpayer is evaluated for each spouse at their own age. Without it one household age applies to both.
    engine step (compute_state_tax_detail). Engine convention, no external source: The engine cannot know the second spouse's age unless told.
  2. Rate schedule and standard deduction by filing status Single uses the single schedule and deduction; married filing jointly the joint ones. Head of household and married filing separately follow the two steps below.
    Wisconsin's values · engine step (select_brackets). Sources (Rate schedule): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  3. Married filing separately Where the state publishes its own separate schedule, that one (with half the joint deduction unless a separate deduction is set). Where one schedule applies to every status, that schedule unscaled with the single deduction. Otherwise the joint schedule with every threshold and the deduction halved (computed as the joint tax on twice the income, halved).
    Wisconsin's values · engine step (select_brackets). Sources (Rate schedule): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  4. Head of household The state's head-of-household schedule where it has one, else the single schedule; the head-of-household deduction where set, else the single deduction.
    Wisconsin's values · engine step (select_brackets). Sources (Rate schedule): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  5. A separate deduction for married filing separately married filing separately Where set, this amount replaces the deduction the schedule rule above gives married filing separately.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Deductions, exemptions and credits): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  6. The income total every income test uses Other ordinary income + retirement distributions (before any exclusion) + conversion + federally taxable Social Security + long-term gains. It stands in for federal adjusted gross income in every threshold, cliff and phase-out below; state subtractions do not reduce it.
    engine step (compute_state_tax_detail). Engine convention, no external source: The inputs are the federal AGI components, so their sum is federal AGI for these income types.
  7. Attributing income to each spouse joint returns with each spouse's own amounts given With a caller's split (the API's spouse object), each spouse's own distributions, pension, public pension, conversion, wages and military pay; spouse 2's shares are clamped into the household totals and spouse 1 gets the rest. Without a split, in per-person mode, every item is divided 50/50. Social Security, other ordinary income and gains are always divided 50/50 where a rule needs a per-person amount. The split is used only where a state's rule is per taxpayer; household totals stay authoritative for the base and the income tests.
    engine step (compute_state_tax_detail). Engine convention, no external source: Equal attribution is the neutral split when the owner of a dollar is not known.
  8. Keeping the per-spouse shares inside the household joint returns with each spouse's own amounts given After the public-pension and employer-pension carve-outs, if the two spouses' remaining shares add up to more than the household's exclusion-eligible distributions (an inconsistent split), spouse 1's share is reduced so they do not.
    engine step (compute_state_tax_detail). Engine convention, no external source: Input normalisation.
  9. Military retirement pay The state's military rule runs first, on military pay alone, per taxpayer: each spouse's own pay at their own age when attributed, otherwise half each at the household age on a joint return. Exempt dollars leave the base; the rest become pension dollars for the general retirement rules.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Military retirement pay): Pcs retired (checked 2026-09-27)
  10. One taxpayer's military exemption Exempt: all of it (below the age split, up to the younger cap). Capped: up to the cap for the age tier, plus the earned-income bonus below the age split when the taxpayer's own wages exceed the threshold, less the taxpayer's own Social Security where the rule says so. Percentage: the percentage (below the age split, up to the younger cap). Then the income limit: above it the exemption is lost, or phased out over the range where one is set.
    Wisconsin's values · engine step (military_exempt_one). Sources (Military retirement pay): Pcs retired (checked 2026-09-27)
  11. Social Security exempt None of the federally taxable benefit enters the base.
    Wisconsin's values · engine step (ss_amount_in_state_base). Sources (Social Security): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  12. Does a conversion draw the retirement cap? Where the state lets a conversion draw the capped exclusion, and the filer is at or above the conversion age, the conversion is pooled with distributions against the cap.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Roth conversions): 2025 Wisconsin Form 1 Instructions (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27)
  13. Retirement exclusion per spouse (both ages known) joint returns with the spouse's age given Full-exclusion states exclude each qualifying spouse's own dollars. Capped states give each spouse the single cap for their own age against their own eligible dollars (pension dollars only where the exclusion is pension-only; employer dollars only below the IRA age), less their military exclusion and half of any Social Security offset. Per-return states (and the pooled-if-both-qualify rule when both qualify) apply the joint cap to the couple's pooled eligible dollars when either spouse qualifies. The income tests then apply once to the summed deduction.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (IRA, 401(k) and private pensions): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  14. Conversion pooled with distributions The conversion joins the distributions against the one cap (with a spouse split in a per-taxpayer state, each spouse's own distributions and conversion against that spouse's cap). Nothing of the conversion is added separately.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Roth conversions): 2025 Wisconsin Form 1 Instructions (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27)
  15. Retirement exclusion (household) The distributions eligible for the exclusion go through the exclusion below. Taxable public-pension dollars left by a cap are not eligible; below the IRA age only employer-plan dollars are.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (IRA, 401(k) and private pensions): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  16. Conversion taxed or exempt In full-exclusion states a conversion is exempt at the qualifying age (at any age where the state says so). Elsewhere, unless pooled above, it is ordinary income taxed in full.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Roth conversions): 2025 Wisconsin Form 1 Instructions (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27)
  17. Cap by age tier The full cap at or above the exclusion age, the lower cap at or above the partial age, otherwise none. Joint returns use the joint cap; every other status the single cap.
    Wisconsin's values · engine step (retirement_distributions_in_state_base). Sources (IRA, 401(k) and private pensions): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  18. The capped deduction Deduction = the smaller of the eligible distributions and the cap, then reduced by the income limit above; the rest of the distributions stays in the base.
    Wisconsin's values · engine step (retirement_distributions_in_state_base). Sources (IRA, 401(k) and private pensions): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  19. One taxpayer's cap joint returns with the spouse's age given For per-spouse calculations, each spouse's cap is the single-column cap for their age tier.
    Wisconsin's values · engine step (per_taxpayer_cap_single). Sources (IRA, 401(k) and private pensions): 2025 Wisconsin Schedule SB Instructions (Subtractions from Income) (checked 2026-09-27); Tax Practitioner Fall 2025 Questions and Answers (checked 2026-09-27); Publication 126: How Your Retirement Benefits Are Taxed (checked 2026-09-27)
  20. Long-term gains in the base Where gains are taxed as ordinary income: net long-term gain less the flat exclusion (never below zero), times the inclusion share. Elsewhere none enters.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Capital gains): 2025 Wisconsin Schedule WD Instructions (Capital Gains and Losses) (checked 2026-09-27)
  21. Standard deduction phase-out Above the start the deduction is scaled by 1 − (income − start) / width, down to zero, with head-of-household and separate starts where the state has them; where the state says so a head of household never gets less than the single deduction at the same income.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Deductions, exemptions and credits): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  22. Personal exemption The joint amount on a joint return, the head-of-household amount where set, otherwise the single amount.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Deductions, exemptions and credits): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  23. Age subtraction At or above the age: the single amount, or the joint amount on a joint return (both spouses at the household age). In per-person mode, half the joint amount (or the single amount) per qualifying spouse. Plus the low-income amount below the income test; less the military exclusion where the statute says so; limited to the spouse's own income where the statute says so.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Age 65+ subtractions and credits): 2026 Form1 ES Inst (checked 2026-09-27)
  24. State taxable income Other ordinary income + Social Security, retirement income, conversion and gains left in the base − standard deduction − personal exemption − age subtractions.
    engine step (compute_state_tax_detail). Engine convention, no external source: The order of subtraction follows the state forms; each amount is sourced at its own step.
  25. No tax at or below zero State taxable income at or below zero returns a tax of 0 (credits are not refundable and nothing below applies).
    engine step (compute_state_tax_detail). Engine convention, no external source: Every credit the engine carries is nonrefundable, so nothing below can make a zero tax negative; each credit is sourced at its own step.
  26. Separate-return scaling married filing separately For the halved-joint rule, taxable income is doubled before the schedule and the result halved.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Rate schedule): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  27. The rate schedule Each bracket's rate on the part of taxable income inside it, summed. No rounding: the result is carried in full precision.
    Wisconsin's values · engine step (apply_state_brackets). Sources (Rate schedule): 2026 Form 1-ES Instructions (Wisconsin Estimated Tax Voucher Instructions) (checked 2026-09-27)
  28. Married couple credit joint returns with each spouse's own amounts given Joint returns with the spouse's age and a spouse split only, and only when no retirement exclusion was taken: the rate times the lower-earning spouse's wages, up to the maximum.
    Wisconsin's values · engine step (compute_state_tax_detail). Sources (Wages): 6 (checked 2026-09-27); Pcs retired (checked 2026-09-27)
  29. Credits cannot make the tax negative The credits are subtracted and the result floored at zero.
    engine step (compute_state_tax_detail). Engine convention, no external source: Every credit the engine carries is nonrefundable; each credit is sourced at its own step.

Rate schedule

Single

Taxable income fromtoRate
$0$15,1103.5%
$15,110$51,9504.4%
$51,950$332,7205.3%
$332,720and up7.65%

Married filing jointly

Taxable income fromtoRate
$0$20,1503.5%
$20,150$69,2604.4%
$69,260$443,6305.3%
$443,630and up7.65%

Head of household uses the single schedule.

Married filing separately

Taxable income fromtoRate
$0$10,0803.5%
$10,080$34,6304.4%
$34,630$221,8205.3%
$221,820and up7.65%

Deductions, exemptions and credits

  • Standard deduction (or the exemption the engine carries in its place): $13,960 single, $25,840 married filing jointly, $18,030 head of household.
  • The standard deduction phases out ratably as income rises above $20,120 (single) and $29,040 (MFJ), reaching zero $116,333 and $130,650 above those points; head of household from $20,120 over $80,080; married filing separately from $13,780 over $62,089.
  • The head-of-household deduction never falls below the single deduction at the same income.
  • Married filing separately: $12,280.
  • Personal exemption, subtracted in addition: $700 single, $1,400 MFJ.

Age 65+ subtractions and credits

  • At age 65 or older: $250 is subtracted from the base ($500 for a married couple filing jointly when both qualify), against any income. With the spouse's age given, each spouse qualifies on their own age.

Social Security

Social Security benefits are fully exempt: none of the federally taxable amount enters the state base.

API value: socialSecurityRule: "exempt". The engine's input is the federally taxable amount; income tests use the sum of the income components as the adjusted-gross-income proxy.

IRA, 401(k) and private pensions

  • Pension, annuity and IRA/401(k) distributions: up to $24,000 excluded per taxpayer ($48,000 on a joint return) at age 67 or older.
  • Joint returns: when both spouses pass the age test the $48,000 cap applies to their pooled income; when only one does, only that spouse's own income draws a cap.

Source review notes (what the sources do not state outright, or what the engine does not carry):

Public pensions

No separate treatment: public pensions follow the rules for other retirement income above.

Source review notes (what the sources do not state outright, or what the engine does not carry):

Military retirement pay

  • Military retirement pay is fully exempt, at any age.
  • Rules are applied per taxpayer at that person's own age when the spouse's age is given. API value: rules.militaryRetirement.treatment: "exempt".

Wages

  • Wages are ordinary income.
  • Married couple credit: 3% of the lower-earning spouse's earned income, up to $480. Applied only on a joint return where each spouse's wages and the spouse's age are given.

Roth conversions

A conversion draws the retirement-income exclusion together with distributions from age 67; the part above the cap is taxed as ordinary income.

Capital gains

  • 70% of net long-term gain enters the base (30% is excluded) and is taxed at ordinary rates.
  • Short-term gains are ordinary income.

Source review notes (what the sources do not state outright, or what the engine does not carry):

Worked examples

Computed by the engine for the fixed households below (the same ones for every state, so states compare directly). Federal tax is not supplied, so a federal-tax deduction is not taken; the income tests use the sum of the components as income.

Household (engine inputs)State tax
Single, 67: $30,000 private pension, $20,000 IRA, $10,000 interest, $24,000 Social Security ($17,000 federally taxable), $5,000 long-term gain$1,272.70
Married filing jointly, 70: $40,000 public pension, $40,000 IRA, $20,000 interest, $40,000 Social Security ($34,000 federally taxable), $10,000 long-term gain$2,194.51
Single, 60: $60,000 other ordinary income and a $50,000 Roth conversion$5,021.12
Married filing jointly, 66: $30,000 IRA, a $40,000 Roth conversion, $30,000 Social Security ($25,500 federally taxable)$2,256.45
Single, 58: $36,000 military retirement pay and $30,000 wages$781.22
Married filing jointly, ages 67 and 61: $50,000 IRA, $10,000 interest, $30,000 Social Security ($25,500 federally taxable), each spouse's age given$688.68

Line by line

The intermediate lines the engine records while it computes each example (its detail record, printed as it comes out; lines that are zero are left out). The engine's documentation build checks that the lines add up to the taxable income and the tax, for every state, filing status and a grid of households. Each line links the engine step that produces it.

Single, 67: $30,000 private pension, $20,000 IRA, $10,000 interest, $24,000 Social Security ($17,000 federally taxable), $5,000 long-term gain: $1,272.70
Married filing jointly, 70: $40,000 public pension, $40,000 IRA, $20,000 interest, $40,000 Social Security ($34,000 federally taxable), $10,000 long-term gain: $2,194.51
Single, 60: $60,000 other ordinary income and a $50,000 Roth conversion: $5,021.12
Married filing jointly, 66: $30,000 IRA, a $40,000 Roth conversion, $30,000 Social Security ($25,500 federally taxable): $2,256.45
Single, 58: $36,000 military retirement pay and $30,000 wages: $781.22
Married filing jointly, ages 67 and 61: $50,000 IRA, $10,000 interest, $30,000 Social Security ($25,500 federally taxable), each spouse's age given: $688.68

What the engine does not calculate, and known approximations

What the engine does not calculate for any state (itemized deductions, credits beyond those listed, part-year residents, dependents, blindness and disability, and more) is listed on the calculation order page.

Verification

Worksheet-tested Engine 1.2.0 tests follow the 2026 Form 1-ES standard-deduction table, including the head-of-household and MFS rows.