Filed
/
Library
/
Individuals

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.

On this page
“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.

CodeWhat it reports (2026 instructions)Where it goes on the individual return
AUncollected social security or RRTA tax on tipsSchedule 2, line 13
BUncollected Medicare tax on tipsSchedule 2, line 13
CTaxable cost of group-term life insurance over $50,000Already in boxes 1, 3 and 5; no separate entry
DElective 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
EElective deferrals under a section 403(b) salary reduction agreementForm 8880, line 2, if the saver's credit applies; excess deferrals on Form 1040, line 1h
FElective 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
GElective deferrals and employer contributions (including nonelective deferrals) to any governmental or nongovernmental section 457(b) deferred compensation planForm 8880, line 2, for a governmental plan, if the saver's credit applies
HElective deferrals under section 501(c)(18)(D) tax-exempt organization planSchedule 1, line 24f; Form 8880, line 2
JNontaxable sick payInformation only; not in box 1, 3 or 5
K20% excise tax on excess golden parachute paymentsSchedule 2, line 17k
LSubstantiated employee business expense reimbursementsNontaxable; no entry
MUncollected social security or RRTA tax on taxable cost of group-term life insurance over $50,000 (for former employees)Schedule 2, line 13
NUncollected Medicare tax on taxable cost of group-term life insurance over $50,000 (for former employees)Schedule 2, line 13
PExcludable moving expense reimbursements paid directly to a member of the U.S. Armed Forces or intelligence communityNot in box 1, 3 or 5; no entry
QNontaxable combat payForm 1040, line 1i, only if elected for the earned income credit
REmployer contributions to an Archer MSAForm 8853
SEmployee 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
TAdoption benefitsForm 8839; taxable part from Form 8839, line 31, to Form 1040, line 1f
VIncome from the exercise of nonstatutory stock option(s)Already in boxes 1, 3 and 5; see Pub. 525
WEmployer contributions to a health savings account (HSA)Form 8889, line 9
YDeferrals under a section 409A nonqualified deferred compensation planNo entry named in the employee instructions
ZIncome under a nonqualified deferred compensation plan that fails to satisfy section 409AAlready in box 1; 20% additional tax plus interest on Schedule 2, line 17h
AADesignated Roth contributions under a section 401(k) planForm 8880, line 2, if the saver's credit applies
BBDesignated Roth contributions under a section 403(b) planForm 8880, line 2, if the saver's credit applies
DDCost of employer-sponsored health coverageInformation only; not taxable
EEDesignated Roth contributions under a governmental section 457(b) planForm 8880, line 2, if the saver's credit applies
FFPermitted benefits under a qualified small employer health reimbursement arrangementNo line named in the employee instructions
GGIncome from qualified equity grants under section 83(i)No line named in the employee instructions
HHAggregate deferrals under section 83(i) elections as of the close of the calendar yearNo line named in the employee instructions
IIMedicaid waiver payments excluded from gross income under Notice 2014-7Excluded; Schedule 1, line 8s, only if the payments are also in income
TAEmployer 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
TPTotal amount of cash tips reported to the employer (new for 2026)Schedule 1-A, Part II (qualified tips deduction)
TTTotal 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.

Common miss: treating code DD as income or a deduction
The Instructions for Employee on Form W-2 say the amount reported with code DD is not taxable. Code DD is the cost of employer-sponsored health coverage and is information only.

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.

StepForm 8889 lineAmount
HSA contributions Jordan made directly2$3,000
Contribution limit, self-only coverage, under age 553$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 1112$2,150
HSA deduction: smaller of line 2 or line 1213$2,150
Excess contribution: line 2 less line 13Form 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.

Code W is on Form 8889
Employer HSA contributions from box 12, code W, appear on Form 8889, line 9.
2025 Instructions for Form 8889, line 9
Deferrals are totaled across employers
Codes D, E, F, S, AA, BB and EE from all Forms W-2 are added and compared with the annual limit.
2025 Instructions for Form 1040, line 1h
Uncollected tax is picked up
Amounts under codes A, B, M and N are entered on Schedule 2, line 13.
2025 Instructions for Form 1040, Schedule 2, line 13
Code Z has the additional tax
Code Z income carries the 20% additional tax plus interest on Schedule 2, line 17h.
2025 Instructions for Form 1040, Schedule 2, line 17h
Code DD is not entered as income
The code DD amount is left out of income and deductions.
Form W-2 (2026), Instructions for Employee, box 12
Adoption benefits run through Form 8839
A code T amount is supported by Form 8839, with any taxable part on Form 1040, line 1f.
2025 Instructions for Form 1040, line 1f

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 demo
Example review item
HSA deduction ignores box 12 code W

Form 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.

Source: 2025 Form W-2, box 12, code W

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.

Camron Momeni, CPA
About the author
Camron Momeni, CPA
VP of Tax Experience

Camron Momeni, CPA, has more than 18 years of public accounting and tax startup experience, including 14 years as a CPA serving firms from the Big Four to solo practitioners. He prepared and reviewed returns across partnerships, S corporations, C corporations, exempt organizations, estates and trusts, and as a product manager at Crowe he built K1 Aggregator and C-TRAC, now sold as 990Tracker. At Filed he is VP of Tax Experience, leading customer success, onboarding and solutions engineering.

LinkedIn profile