W2 box 12 codes: every code and where it goes on the return
W2 box 12 codes are the IRS letter codes an employer enters in boxes 12a through 12d of Form W-2 to identify an amount, such as D for 401(k) deferrals, W for employer HSA contributions and DD for health coverage cost. The 2026 instructions list 33 codes, including new codes TA, TP and TT, and each one feeds a different line or none.
“Even if only one item is entered, you must use the IRS code designated for that item.” IRS, General Instructions for Forms W-2 and W-3 (2026)
What are the W2 box 12 codes?
W2 box 12 codes are the one-letter and two-letter IRS codes an employer puts in boxes 12a through 12d of Form W-2 to label an amount, such as D for 401(k) deferrals or W for employer HSA contributions. The 2026 General Instructions for Forms W-2 and W-3 list 33 codes. The instructions say the codes don't relate to which of boxes 12a to 12d they sit in, so code D can appear in box 12a or 12c.
Some box 12 amounts are already inside box 1 wages and some are not. Code C and code V amounts are included in boxes 1, 3 and 5, while pre-tax deferrals under codes D, E, F, G and S are left out of box 1. A paper Copy A carries no more than four box 12 items, according to the 2026 instructions, so a fifth code means a second Form W-2 from the same employer; an electronic file can hold every type. Unlabeled employer items belong in box 14a for 2026, covered on the W-2 box 14 codes page.
Where does each box 12 code go on the return?
Each box 12 code either feeds a specific form or line on the individual return or is information only. The code meanings below are from the 2026 General Instructions for Forms W-2 and W-3. The destinations come from the Instructions for Employee on the 2026 Form W-2, the 2025 Instructions for Form 1040 and the 2025 Forms 8880 and 8889, with line numbers from the 2025 return.
| Code | What it reports (2026 instructions) | Where it goes on the individual return |
|---|---|---|
| A | Uncollected social security or RRTA tax on tips | Schedule 2, line 13 |
| B | Uncollected Medicare tax on tips | Schedule 2, line 13 |
| C | Taxable cost of group-term life insurance over $50,000 | Already in boxes 1, 3 and 5; no separate entry |
| D | Elective deferrals under a section 401(k) cash or deferred arrangement (plan) | Form 8880, line 2, if the saver's credit applies; excess deferrals on Form 1040, line 1h |
| E | Elective deferrals under a section 403(b) salary reduction agreement | Form 8880, line 2, if the saver's credit applies; excess deferrals on Form 1040, line 1h |
| F | Elective deferrals under a section 408(k)(6) salary reduction SEP (includes deferrals to a Roth SEP IRA) | Form 8880, line 2, if the saver's credit applies; excess deferrals on Form 1040, line 1h |
| G | Elective deferrals and employer contributions (including nonelective deferrals) to any governmental or nongovernmental section 457(b) deferred compensation plan | Form 8880, line 2, for a governmental plan, if the saver's credit applies |
| H | Elective deferrals under section 501(c)(18)(D) tax-exempt organization plan | Schedule 1, line 24f; Form 8880, line 2 |
| J | Nontaxable sick pay | Information only; not in box 1, 3 or 5 |
| K | 20% excise tax on excess golden parachute payments | Schedule 2, line 17k |
| L | Substantiated employee business expense reimbursements | Nontaxable; no entry |
| M | Uncollected social security or RRTA tax on taxable cost of group-term life insurance over $50,000 (for former employees) | Schedule 2, line 13 |
| N | Uncollected Medicare tax on taxable cost of group-term life insurance over $50,000 (for former employees) | Schedule 2, line 13 |
| P | Excludable moving expense reimbursements paid directly to a member of the U.S. Armed Forces or intelligence community | Not in box 1, 3 or 5; no entry |
| Q | Nontaxable combat pay | Form 1040, line 1i, only if elected for the earned income credit |
| R | Employer contributions to an Archer MSA | Form 8853 |
| S | Employee salary reduction contributions under a section 408(p) SIMPLE plan (includes contributions to a Roth SIMPLE IRA) | Form 8880, line 2, if the saver's credit applies; excess deferrals on Form 1040, line 1h |
| T | Adoption benefits | Form 8839; taxable part from Form 8839, line 31, to Form 1040, line 1f |
| V | Income from the exercise of nonstatutory stock option(s) | Already in boxes 1, 3 and 5; see Pub. 525 |
| W | Employer contributions to a health savings account (HSA) | Form 8889, line 9 |
| Y | Deferrals under a section 409A nonqualified deferred compensation plan | No entry named in the employee instructions |
| Z | Income under a nonqualified deferred compensation plan that fails to satisfy section 409A | Already in box 1; 20% additional tax plus interest on Schedule 2, line 17h |
| AA | Designated Roth contributions under a section 401(k) plan | Form 8880, line 2, if the saver's credit applies |
| BB | Designated Roth contributions under a section 403(b) plan | Form 8880, line 2, if the saver's credit applies |
| DD | Cost of employer-sponsored health coverage | Information only; not taxable |
| EE | Designated Roth contributions under a governmental section 457(b) plan | Form 8880, line 2, if the saver's credit applies |
| FF | Permitted benefits under a qualified small employer health reimbursement arrangement | No line named in the employee instructions |
| GG | Income from qualified equity grants under section 83(i) | No line named in the employee instructions |
| HH | Aggregate deferrals under section 83(i) elections as of the close of the calendar year | No line named in the employee instructions |
| II | Medicaid waiver payments excluded from gross income under Notice 2014-7 | Excluded; Schedule 1, line 8s, only if the payments are also in income |
| TA | Employer contributions under a section 128 Trump account contribution program paid to a Trump account of an employee or a dependent of an employee (new for 2026) | Excluded from gross income; no line named |
| TP | Total amount of cash tips reported to the employer (new for 2026) | Schedule 1-A, Part II (qualified tips deduction) |
| TT | Total amount of qualified overtime compensation (new for 2026) | Schedule 1-A, Part III (qualified overtime deduction) |
The saver's credit entries rest on the 2025 Form 8880, whose line 2 instructions cover elective deferrals, including designated Roth contributions, to a 401(k), 403(b), governmental 457(b), SEP or SIMPLE plan and say these amounts may be shown in box 12. Codes with no line named are still worth reading, because the amount may already sit in box 1.
What changed in box 12 for 2025 and 2026?
Box 12 gained three codes for 2026 under P.L. 119-21: TA for employer contributions to a Trump account, TP for cash tips reported to the employer, and TT for qualified overtime compensation. The 2026 General Instructions for Forms W-2 and W-3 list all three under What's New. The 2025 instructions and the 2025 Form W-2 have none of them.
- Code TP. The employer reports the total cash tips reported to it and must also enter a Treasury Tipped Occupation Code in new box 14b.
- Code TT. The 2026 instructions say only the "half" portion of time-and-a-half pay required by section 7 of the Fair Labor Standards Act is reported.
- Code TA. Beginning July 4, 2026, employers may contribute up to $2,500 a year to the Trump account of an employee or an employee's dependent.
For 2025 returns, the Form 1040 instructions say no changes were made to Form W-2 to separately account for qualified overtime, and some employers may show it in box 14. A 2025 tips deduction on Schedule 1-A starts from box 7 or the employee's own records.
Which box 12 codes carry a tax or a limit?
Box 12 codes A, B, M, N, K and Z each mean tax is still owed on the return, according to the 2025 Instructions for Form 1040. Uncollected social security and Medicare tax under codes A and B, or M and N, goes on Schedule 2, line 13. The 20% excise tax on excess golden parachute payments under code K goes on Schedule 2, line 17k. Code Z income is already in box 1, and the additional 20% tax plus interest goes on line 17h.
Deferral codes carry a limit. The Instructions for Employee on the 2026 Form W-2 say elective deferrals (codes D, E, F and S) and designated Roth contributions (codes AA, BB and EE) under all plans are generally limited to a total of $24,500 for 2026, and code H deferrals to $7,000. The 2025 Form 1040 instructions use $23,500 for 2025 and put any excess on line 1h, except excess designated Roth contributions, which are already in box 1.
What does a code W reconciliation look like?
For example, Jordan, age 40, had self-only HDHP coverage for all of 2025. Jordan's 2025 Form W-2 shows code D $12,000, code W $2,150 and code DD $9,800 in box 12. Jordan also deposited $3,000 into the HSA from a personal bank account during 2025.
| Step | Form 8889 line | Amount |
|---|---|---|
| HSA contributions Jordan made directly | 2 | $3,000 |
| Contribution limit, self-only coverage, under age 55 | 3 | $4,300 |
| Limit after Archer MSA and spouse adjustments (none) | 8 | $4,300 |
| Employer contributions (Form W-2, box 12, code W) | 9 | $2,150 |
| Line 8 less line 11 | 12 | $2,150 |
| HSA deduction: smaller of line 2 or line 12 | 13 | $2,150 |
| Excess contribution: line 2 less line 13 | Form 5329, Part VII | $850 |
Jordan deducts $2,150 on Schedule 1 (Form 1040), Part II, line 13, not the $3,000 deposited. The Form 8889 instructions say that when line 2 is more than line 13, more was contributed than is allowed, and the $850 difference is an excess contribution unless it is withdrawn. Code D stays off the wage line because the $12,000 is under the $23,500 limit for 2025, and code DD needs no entry.
What do reviewers check on W-2 box 12 codes?
Reviewers check that every code on every Form W-2 was keyed with its letter, since a miskeyed code moves the amount to a different form. A W typed as a D drops the HSA from Form 8889 and adds a deferral that never happened.
The second pass adds amounts across employers. Deferral limits and the HSA limit apply per taxpayer, so the totals matter more than any one form, and a taxpayer with two employers needs both sets of codes side by side. For returns with wages over the Additional Medicare Tax threshold, Form 8959 uses boxes 5 and 6, not box 12. The 2026 codes TP and TT will need their own tie-out to Schedule 1-A once the 2026 return instructions are final.
Which guides go with W-2 box 12 codes?
Preparers working on W-2 box 12 codes usually need these library guides next. Each one covers the related form or rule line by line, with a worked example and review checks.
Every line checked against the documents the client sent
Filed reads the client's Forms W-2, Form 5498-SA and HSA statements, then checks every box 12 code entry on Form 1040 and its schedules against them. Anything that doesn't tie comes back as a review item with a citation to the source.
Book a demoForm 8889 line 13 shows a $3,000 deduction with nothing on line 9, but the W-2 reports $2,150 of employer HSA contributions under code W. With line 9 filled in, the deduction is $2,150 and $850 is an excess contribution. Confirm the HDHP coverage type and whether the $850 was withdrawn.
Common questions
What does code DD mean in box 12 of a W-2?
Code DD in box 12 of a W-2 is the cost of employer-sponsored health coverage. The Instructions for Employee on Form W-2 say the amount reported with code DD is not taxable, so code DD is information only and doesn't change wages or create a deduction on the individual return.
What does code W mean in box 12 of a W-2?
Code W in box 12 of a W-2 is employer contributions to a health savings account, including amounts the employee contributed through a section 125 cafeteria plan. The Instructions for Employee on Form W-2 say to report it on Form 8889, and the 2025 Form 8889 instructions put the code W amount on line 9.
What are the new W-2 box 12 codes for tips and overtime?
The new W-2 box 12 codes for tips and overtime are TP and TT, added for 2026. The 2026 General Instructions for Forms W-2 and W-3 use code TP for total cash tips reported to the employer and code TT for total qualified overtime compensation. A third new code, TA, reports employer contributions to a Trump account. None of the three is on the 2025 Form W-2.
