Form 499R-2/W-2PR: Boxes, Corrections, and Federal Filing

Form 499R-2/W-2PR is Puerto Rico’s version of the federal W-2. It reports your annual wages and the Puerto Rico income tax your employer withheld. Your employer sends the 499R-2 copy to the Puerto Rico Department of Treasury (Hacienda) and gives you the W-2PR copy to file with your Puerto Rico individual income tax return. Whether the same wages also belong on a U.S. federal return depends on whether you were a bona fide resident of Puerto Rico for the entire tax year.

Reading the Boxes That Matter

The form has more than two dozen boxes. Only a handful drive your return.

Wages and Total Compensation

Boxes 7 through 10 split your taxable pay into components: base wages in Box 7, commissions in Box 8, allowances in Box 9, and tips in Box 10. Box 11 is the sum of those four and represents your total compensation subject to Puerto Rico income tax. Box 11 is the main figure you carry to your Puerto Rico return.¹

Tax Withheld and Pre-Tax Contributions

Box 13 shows the total Puerto Rico income tax your employer withheld during the year. That amount is credited directly against your tax liability on your return, and it decides whether you get a refund or owe more. Box 14 reports contributions to a governmental retirement fund. Box 15 reports contributions to a qualified retirement plan (a CODA plan, similar to a 401(k)). Box 6 captures charitable contributions made through payroll deductions. Each of these can reduce taxable income or work as an adjustment when you file.¹

Exempt Salaries

Boxes 16, 17, and 18 report different categories of exempt salary. These amounts are paid by your employer but excluded from Puerto Rico income tax under specific code provisions, and they are not included in the Box 11 total. If any of these boxes has a figure, check your return instructions on how the exclusion interacts with deductions you plan to claim.

Social Security and Medicare

Federal payroll taxes still apply in Puerto Rico. Box 20 shows wages subject to Social Security tax, and Box 21 shows the Social Security tax withheld. For 2026, Social Security tax applies to the first $184,500 in covered earnings at the 6.2% employee rate.² Medicare tax has no cap and applies at 1.45% on all covered wages, with an additional 0.9% surtax on earnings above $200,000 ($250,000 for married filing jointly). Boxes 25 and 26 appear only if your employer couldn’t collect Social Security or Medicare tax on reported tips.

When You Should Have the Form

Your employer must give you the W-2PR by January 31 of the year following the tax year. If you haven’t received yours by early February, ask payroll before contacting Hacienda.³ Employers may deliver the form electronically instead of on paper if they meet Internal Revenue Circular Letter No. 16-11. If your employer does that, confirm you can access the form before filing season.

If a Box Is Wrong

Contact your employer and ask for a correction. Puerto Rico uses Form 499R-2c/W-2cPR for corrected wage statements, and your employer files the corrected version with Hacienda through SURI. Don’t file your return with numbers you know are wrong just to hit the deadline; an extension is safer than filing bad data that draws a Hacienda notice later.

Filing Your Puerto Rico Return

The numbers on your W-2PR feed into Formulario 482, the Puerto Rico individual income tax return. You transfer Box 11 (total taxable compensation) and Box 13 (tax withheld) to the corresponding lines. Box 13 counts as a payment credit against your liability. After the tax rates apply to your taxable income, you either owe the difference or receive a refund.

Most taxpayers file electronically through SURI. Enter the W-2PR data precisely: Hacienda cross-references your return against the employer’s copy already on file. The individual income tax return is generally due April 15 of the following year.

Do the Same Wages Go on a Federal Return?

That depends on your residency for federal purposes, and the answer changes everything about your federal filing.

The Bona Fide Residency Test

Under Section 937 of the Internal Revenue Code, you qualify as a bona fide resident of Puerto Rico only if you meet all three tests for the full tax year:⁴

Presence test: physically present in Puerto Rico for at least 183 days during the tax year.
Tax home test: your tax home was in Puerto Rico, and you had no tax home elsewhere at any point in the year.
Closer connection test: no closer connection to the mainland United States or any foreign country than to Puerto Rico.

All three must be satisfied for the same full year. Failing any one changes your federal obligations.⁵

If You Pass All Three Tests

Section 933 lets bona fide residents exclude Puerto Rico-sourced income from federal gross income. The wages on your W-2PR do not go on Form 1040. One exception: wages earned as an employee of the United States government or a federal agency are not excluded and must be reported federally.⁶

If your only income came from Puerto Rico sources, you generally don’t need to file a federal return at all. If you also had non-Puerto Rico income (mainland investments, rental property, or freelance work for stateside clients) you file Form 1040 when that outside income exceeds the standard filing threshold. On that return, you report only the non-Puerto Rico income and leave the W-2PR wages off.⁷

There’s a catch. When you exclude Puerto Rico income under Section 933, you can’t take the full federal standard deduction. You reduce it by the ratio of your U.S.-taxable gross income to your total gross income from all sources, including the excluded Puerto Rico wages. IRS Publication 570 walks through the calculation.⁸ Publication 1321 provides a worksheet for bona fide residents who must file federally, covering which income is subject to U.S. tax and whether you meet the filing threshold once excluded income is set aside.⁹

If You Don’t Pass All Three

If you worked in Puerto Rico but did not meet every part of the bona fide residency test, you must report worldwide income on Form 1040, including the wages from your W-2PR. To avoid double taxation, claim the foreign tax credit by filing Form 1116 with your federal return.¹⁰ The Puerto Rico income tax in Box 13 is the basis for the credit calculation, and it reduces your federal tax dollar-for-dollar up to the Form 1116 limit. You can sometimes claim the credit without Form 1116, but the election has limits that make Form 1116 the safer route for most people with significant Puerto Rico income.

The Year You Leave Puerto Rico

Section 933 also gives a partial exclusion to U.S. citizens who were bona fide residents of Puerto Rico for at least two years before changing residence. In the year you move, you can still exclude Puerto Rico-sourced income attributable to the part of the year when you were a bona fide resident. Income earned after the move goes on your federal return with no exclusion.⁶

1
Department of the Treasury (Government of Puerto Rico). Publication 25-01 – Developer Guide Form 499R-2/W-2PR (Copy A) Electronic Filing Requirements
2
Social Security Administration. Contribution and Benefit Base
3
Internal Revenue Service. New Electronic Filing Requirements for Forms 499R-2/W-2PR
4
Office of the Law Revision Counsel. 26 USC 937 – Residence and Source Rules Involving Possessions
5
Internal Revenue Service. U.S. Territories – Determining Bona Fide Residency Status
6
Office of the Law Revision Counsel. 26 USC 933 – Income From Sources Within Puerto Rico
7
Internal Revenue Service. Topic No. 901, Is a Person with Income from Sources Within Puerto Rico Required to File a U.S. Federal Income Tax Return?
8
Internal Revenue Service. Publication 570 – Tax Guide for Individuals With Income From U.S. Territories
9
Internal Revenue Service. Publication 1321 – Special Instructions for Bona Fide Residents of Puerto Rico Who Must File a U.S. Individual Income Tax Return
10
Internal Revenue Service. Instructions for Form 1116 – Foreign Tax Credit (Individual, Estate, or Trust)