W-2 Box 12 Code W — Employer and employee HSA contributions
Total Health Savings Account contributions — both employer and employee (via pre-tax payroll). Capped at the §223 annual HSA limit for your HDHP coverage tier, plus the $1,000 age-55+ catch-up under §223(b)(3)(B)(ii).
At a glance — Box 12 Code W
- Box name
- Employer and employee HSA contributions
- Reports to
- Must be reconciled on Form 8889, Part I.
- Check against
- Form 5498-SA from your HSA administrator (issued in May) plus your final pay stub's YTD HSA payroll deduction — both should sum to code W, which Form 8889 then reconciles against your HDHP coverage tier's annual limit.
What Box 12 Code W means
Code W reports the total HSA contributions made through your employer — both what your employer contributed directly and what you contributed via pre-tax payroll deduction under a §125 cafeteria plan. The IRS instructions describe this as employer contributions 'including amounts the employee elected to contribute using a section 125 (cafeteria) plan,' which is why your own payroll deductions land in the employer-side box rather than being treated as a separate personal contribution.
You must file Form 8889 for any year you (or your employer) made HSA contributions, or your HSA made a distribution — there's no minimum threshold. Code W flows to Form 8889, Line 9. If you also contributed directly to your HSA outside of payroll — sending money to the HSA custodian rather than having it deducted from your paycheck — that separate amount goes on Form 8889, Line 2, and is what you deduct above-the-line on Schedule 1, Line 13. Code W itself is never entered on Schedule 1; it's already excluded from Box 1.
Your contribution limit for the year depends on your HDHP coverage tier (self-only or family) and is prorated for any month you weren't HDHP-eligible, unless you qualify for the 'last-month rule' — being HSA-eligible on December 1 lets you contribute the full-year limit even if you weren't covered earlier, but only if you stay eligible through the following December (the 'testing period'). Breaking that condition makes the extra last-month-rule contribution includible in income and subject to a 10% additional tax. If you're 55 or older by year-end, you can add a $1,000 catch-up contribution under §223(b)(3)(B)(ii) — a fixed amount, not inflation-indexed. Each spouse needs their own HSA to use their own catch-up; you can't put a spouse's $1,000 into your account.
Contribute more than your limit for the coverage tier and eligibility period, and the excess is subject to a 6% excise tax for every year it stays in the account, computed on Form 5329. The fix is a corrective distribution — withdrawing the excess (plus any earnings on it) before your filing deadline, including extensions — which avoids the excise tax for that year.
Tax return implications
- Already excluded from Box 1 — employer contributions are never added to wages, and your payroll HSA deductions are pre-tax.
- Does NOT go on Schedule 1, Line 13 — that line is for HSA contributions you made directly, outside payroll.
- Triggers a mandatory Form 8889 filing for the year, regardless of amount.
- If you lose HDHP eligibility mid-year (for example, enrolling in Medicare), your annual limit prorates down to the eligible months unless you separately qualify for and satisfy the last-month rule.
- Amounts above your prorated limit are excess contributions — a 6% excise tax applies each year until corrected.
Common pitfalls & things to check
- If you and your spouse both have HSA-eligible family coverage, coordinate contributions — the family limit is shared between you, and payroll deductions at two employers can silently combine to exceed it.
- Enrolling in Medicare (even Part A only) ends HSA eligibility starting that month — your contribution limit for that month is zero. If your Medicare enrollment is later backdated (common if you delay applying past 65), contributions made during the retroactive coverage period become excess even if your paycheck kept deducting them.
- The $1,000 age-55 catch-up must go into your own HSA — you cannot contribute it to a spouse's account even under family coverage.
- The last-month rule requires staying HSA-eligible through the testing period (December of the following year) — losing eligibility during that window converts the extra last-month-rule contribution into taxable income plus a 10% additional tax, not just a plain excess contribution.
- Skipping Form 8889 when code W is greater than zero causes any HSA distributions on your 1099-SA to default to taxable, since there's no reconciliation showing they were used for qualified medical expenses.
For 2025 returns (filed by April 15, 2026)
- HSA limit (self-only / family)
- $4,300 / $8,550
- HDHP min deductible $1,650 / $3,300 · OOP max $8,300 / $16,600. Age-55+ catch-up adds $1,000 (§223(b)(3)(B)(ii), not indexed).
Values sourced from central tax-year config at build time — update automatically on FY rollover.
FAQ
What does code W on my W-2 mean?
It's the total HSA contribution made through your employer for the year — combining what your employer paid in directly and what you contributed pre-tax via payroll. It does not include anything you contributed to your HSA outside of payroll.
Do I need to file anything because of code W?
Yes — Form 8889 is mandatory for any year you have an amount in code W, or any year your HSA made a distribution. It reconciles your contributions against your HDHP coverage tier's limit and reports whether your distributions were for qualified medical expenses.
Is code W the same as everything I put into my HSA?
Only the payroll portion. If you also sent money to your HSA directly (not through payroll), that's a separate personal contribution reported on Form 8889, Line 2, and deducted on Schedule 1, Line 13 — it isn't part of code W.
What happens if code W is more than my HSA limit?
The excess is subject to a 6% excise tax for every year it remains in the account (Form 5329). Withdrawing the excess and any earnings on it before your filing deadline, including extensions, avoids the tax for that year.
Related W-2 boxes
Box 12 — Codes (401(k), HSA, health coverage, ISO, and more)
Up to four labeled amounts (12a–12d) using IRS codes. Common codes: D (401(k) elective deferral), DD (employer health coverage cost), W (employer + employee HSA contributions), AA (Roth 401(k)).
Box 12 Code D — Elective deferrals to a 401(k) plan
Your traditional (pre-tax) 401(k) elective deferrals. Reduces Box 1 dollar-for-dollar, up to the annual §402(g) elective deferral limit (higher with age-50 catch-up and SECURE 2.0 ages-60–63 super-catch-up).
Box 12 Code DD — Cost of employer-sponsored health coverage
The total cost (employer + employee share) of your employer-sponsored group health coverage. Informational only — does not affect your tax.
Box 12 Code E — Elective deferrals to a 403(b) plan
Your traditional (pre-tax) 403(b) elective deferrals. Reduces Box 1 up to the annual §402(g) limit, with a special 15-year catch-up for long-tenured employees of certain nonprofits.
Reconciling your W-2 at tax time? Use the paycheck calculator to verify expected federal, Social Security, and Medicare withholdings on your salary, and the federal income tax calculator to estimate your refund or balance owing before you file.
Related Calculators
Paycheck Calculator
Federal, state, FICA withholding, net take-home, W-4 alignment
Federal Income Tax Calculator
10–37% brackets, $15,750 standard deduction, progressive calculation
W-4 Withholding Calculator
Form W-4 steps, correct federal withholding, avoid penalties
FICA & Social Security
6.2% SS to $176,100, 1.45% Medicare, 0.9% additional Medicare
Tax Refund Estimator
Estimate federal refund, withholding vs liability, adjustments
401(k) Calculator
Contribution limits, employer match, tax-deferred growth
Sources
W-2 box definitions per IRS General Instructions for Forms W-2 and W-3 and IRC §6051. Rates and thresholds current for tax year 2025 (file by April 15, 2026); 2026 figures included where published.