Your First IRS Filing in Portugal: A Starter's Guide
By Mikael
April came and went in my first year in Portugal, and I genuinely didn't know whether the IRS filing window applied to me. I had a NIF. I'd been in Lagos for about seven months. I had a handful of Recibos Verdes in the system. And the combination of "haven't been here very long" and "how different can it be from Sweden" kept me from properly looking into it until June, when a Portuguese colleague asked if I'd already filed.
I had not.
What followed was two days of reading and trying to understand whether I was even required to file, what would happen if I was and hadn't, and why every guide assumed you already knew whether you were a resident. None of them addressed the step before that.
This is the post I needed then.
TL;DR
You need to file Portuguese IRS for 2025 if you were a tax resident in Portugal that year and had any taxable income. Tax residency (residência fiscal) isn't the same as legal or immigration residency. You can have a residence permit without being a tax resident, and the tax authority cares about the CIRS tests, not the immigration file.
The two main tests under CIRS Art. 16: 183+ days in Portugal in any 12-month period that begins or ends in the year, or holding a dwelling in Portugal at any point during that stay with intent to maintain it as habitual residence. Tax residency starts from your first day of stay, not January 1. If your status changed mid-year, you may need to file two Modelo 3 declarations for the same year: one for the resident period (worldwide income) and one for the non-resident period (Portuguese-source income only).
A NIF alone doesn't make you resident. Registering as a freelancer doesn't either, but once you've registered activity and are resident, you file even if income was zero.
If you have foreign income from during your resident period, it likely belongs in Anexo J. If you became resident in 2025 and never applied for IFICI, that window has already closed.
The IRS step-by-step guide covers the Portal das Finanças walkthrough once you've confirmed you need to file. This guide handles the question that comes before: do you even need to?
Legal residency vs. tax residency
These two are often confused, and the confusion causes real filing errors.
Legal residency is what your AIMA registration certificate or residence permit says. It establishes your right to live in Portugal under immigration law.
Tax residency (residência fiscal) is a separate classification under CIRS. It determines your obligations to the Portuguese tax authority: what you declare and at what rates. You can be a legal resident without being a tax resident in a given year. The Portuguese tax authority cares about the CIRS tests, not the immigration file.
When people say "I'm a resident in Portugal," they usually mean the legal sense. When you're figuring out whether to file IRS, you need to answer the tax-residency question under CIRS Art. 16, which follows its own logic.
Do you actually need to file?
This is the question most people skip past, then panic about when they realize they don't know the answer.
Portuguese tax residency is determined by two independent tests under CIRS Article 16.
The 183-day test. Under Art. 16(1)(a): 183 or more days in Portugal in any 12-month period that begins or ends in the tax year. The days don't have to be consecutive. And the window isn't fixed to the calendar year. Someone who arrived in October 2024 and stayed through April 2025 hits the 183-day mark in a period that ends in 2025, which makes them a 2025 tax resident even if the days straddle two calendar years.
The dwelling test. Under Art. 16(1)(b): fewer days, but you held a dwelling in Portugal at any point during your stay under conditions implying you intended to maintain and occupy it as your habitual residence. This doesn't require a December 31 snapshot. Signing a 12-month lease, buying a flat, moving your household to Portugal: these are strong practical signals of that intent, and they typically mark when the test starts to apply.
Under Art. 16(3), residency begins from the first day of your stay, not January 1. This matters if you arrived partway through the year.
Two things that do not make you resident:
Having a NIF. You need a NIF to rent a flat, open a bank account, buy a car. Plenty of people have Portuguese tax identification numbers without being tax residents. It's an administrative identifier, not a residency registration.
Registering as a freelancer. Opening activity creates obligations going forward, but it doesn't determine when your residency started. Someone who opened activity in November 2025 but only arrived in October hasn't necessarily hit the 183-day threshold for the year.
Why two tests, not one?
The structure isn't a Portuguese peculiarity. The 183-day count and the habitual-home test both trace back to the OECD Model Tax Convention (Article 4), which is the international template countries use when negotiating double-taxation treaties. If you've lived in Sweden, Germany, the UK, or most other EU countries before Portugal, you've likely already met variations of these two tests. Portugal's domestic rules follow the same pattern.
The treaty framework also defines what happens when both Portugal and another country claim you as a tax resident in the same year. The tie-breaker hierarchy works through: permanent home first, then centre of vital interests, then habitual abode, then nationality, then mutual agreement between the authorities. The rules are coordinated internationally, not arbitrary.
Worked examples
You need to file: You arrived in Lisbon in March 2025, signed a 12-month lease, registered your address, and opened activity in May. By December you'd been here well over 183 days and had a home in place. Your tax residency started in March under Art. 16(3). You file 2025 IRS.
You probably don't need to file: You arrived in November 2025, got a NIF to open a bank account, stayed in short-term accommodation, and left in January 2026. Sixty days, no permanent home, no opened activity. You're not a 2025 Portuguese tax resident.
Check your count: You arrived in August 2025, signed a lease in September, opened activity in October. You're close to the borderline. Count the days. If you're above 183, you file. If you're between 120 and 182 but had a lease in place, you likely still file under the dwelling test.
What happens when you arrive mid-year: the split-year situation
Under Art. 16(3), if you weren't resident in Portugal the previous year, your residency starts on your first day of presence. This splits your tax picture for the year.
The resident period (from arrival onwards): worldwide income, taxed the same as any full-year resident.
The non-resident period (before arrival): only Portuguese-source income is taxable.
In a split year, you may need to file two Modelo 3 declarations for the same tax year: one covering the resident portion and one covering the non-resident portion. The change of status is flagged on the Rosto in Quadro 8; partial-year residency specifically requires Quadro 8C.
The morada fiscal myth. This is the single most common tax-residency error in expat Facebook groups: people believe that changing your address on your NIF (the morada fiscal, also called domicílio fiscal) is what sets your tax-residency start date. It is not.
Updating your morada fiscal is an administrative act. AT's records may anchor on that date as a practical matter, which is why the misconception persists. But the law is clear: what determines tax residency is CIRS Art. 16 (the 183-day test and the habitual-dwelling test), and what sets the start date is Art. 16(3): the first day of your stay. Not the date you changed your NIF address. Not the date you registered anywhere.
If AT's recorded start date doesn't match your actual residency start under CIRS Art. 16(3), you set the correct date yourself in Quadro 8 / Quadro 8C when you file. The morada fiscal is evidentiary and administrative; it does not legally determine when residency began. You do.
If you opened activity but had zero income
Once you've registered with AT as a freelancer, you file Modelo 3 for that year even if no Recibos Verdes were issued. The declaration handles this: enter €0 in Anexo B. The registration creates the filing obligation. Income level doesn't change it.
Setting up Portal das Finanças as a newcomer
Before filing anything, you need to log in to Portal das Finanças at portaldasfinancas.gov.pt.
When your NIF was issued, AT mailed a temporary password to your registered address. This is the first common problem: if you used a fiscal representative to get your NIF from outside Portugal, the password may have gone to their address. If you've since moved, it went to an old one.
If you don't have your AT password: Request a new one at any Finanças office. Bring your NIF and identification. You can also request it online, but that sends a physical letter to your registered address, budget one to two weeks.
The better long-term option is Chave Móvel Digital (CMD). CMD is Portugal's digital authentication system: a username plus a one-time code sent to your mobile. It works across Portal das Finanças, Segurança Social Direta, and other government portals. Activate it at a Loja do Cidadão with your NIF and residency document. Once set up, you won't need separate passwords for each government portal.
If the filing window is already open and you're still sorting portal access, that's your bottleneck. You cannot file without it.
What to gather as a first-time filer
A returning filer opens last year's comprovativo and works from there. As a newcomer, you're starting from scratch.
Your Recibos Verdes history. Every invoice you issued through AT is already in the portal. Log in, navigate to Recibos Verdes, and you'll see your complete 2025 record. Total your gross income by category, this feeds Anexo B.
Your activity start date. Needed for Anexo SS (Social Security reconciliation). This determines whether your first-year 12-month SS exemption covered all of 2025 or only part of it.
Your e-fatura expenses. Log in to e-fatura and categorize any unclassified invoices paid with your NIF. Professional expenses that aren't categorized won't appear in your Anexo H deductions. A few minutes here before filing changes the numbers.
Your residency documentation. Your NIF registration, lease, or AIMA residency record: not submitted directly, but it determines your household setup (agregado familiar) in the declaration cover page (Rosto). Get this right; mismatches cause errors that don't surface until after you submit.
Your actual residency start date. If you arrived mid-year, establish when your tax residency under CIRS Art. 16(3) actually began. Entry records, lease start date, first utility in your name: anything that anchors the day. You'll need this for Quadro 8C if your status changed during the year.
Foreign income records. Anything you earned during the resident period abroad, employment income from a foreign employer, foreign pension, interest from a foreign bank account, needs documentation. Tax certificate from your employer, bank statements, records of what was paid in taxes. Income earned before your residency start date falls under different rules. This goes in Anexo J.
The foreign income question
This is the one that surprises most first-year filers.
Portugal taxes its residents on worldwide income. But the relevant period starts when residency started, not January 1. If you arrived in July 2025, Portugal's worldwide-income claim runs from July. Salary from your German employer before July is not subject to Portuguese worldwide taxation under the partial-year rules.
Income earned during the resident period, wherever it came from, gets declared. The mechanism that prevents paying tax twice is the double taxation treaty (DTA) between Portugal and your home country. Portugal has agreements with most EU countries, the UK, the US, and many others. Under a typical treaty, the income is either exempt from Portuguese tax, or Portugal credits the foreign tax already paid.
The practical consequence: you declare the relevant income in Anexo J, provide the documentation, and let the treaty do its work. What you don't do is leave Anexo J out because "that was from before I moved here" when it was earned after your residency started.
Through automatic exchange of information agreements (the EU's DAC framework and FATCA for US citizens), AT receives income data from foreign tax authorities. Your declaration and their records need to match.
If the foreign income situation is complex, a contabilista certificado who handles expat situations is worth consulting for your first filing. A straightforward "six months employed in the UK, then freelancing in Portugal" situation is manageable with Anexo J, the split-year rules, and the right documentation.
NHR / IFICI: did you miss the window?
If you became a Portuguese tax resident in 2024 or 2025, the relevant scheme is IFICI. NHR (Non-Habitual Resident) closed to new applicants at the end of 2023.
IFICI offers a flat 20% IRS rate on qualifying Portuguese-source income for 10 years. It's targeted at researchers, qualified tech professionals, and certain other roles, narrower than NHR was. If you qualify and applied in time, it matters significantly for your tax bill.
The deadline for 2025: January 15, 2026. If you became resident in 2025 and didn't apply by then, you cannot claim IFICI for 2025. Your 2025 filing is at standard progressive rates.
You can still apply for 2026 (deadline January 15, 2027) if you remain resident and your activity qualifies. But 2025 is closed.
If you're not certain whether you applied, check your AT portal profile. Approved IFICI status appears there, and using it in your filing requires Anexo L. If you don't see it and have no memory of applying, you're on standard rates for 2025. The NHR vs IFICI guide covers the eligibility criteria and how the regime affects your declaration in more detail.
Common first-year mistakes
Treating "the window opened April 1" as a deadline. The filing window runs April 1 through June 30. Opening doesn't mean due. You have three months.
Leaving Anexo J out. Foreign income earned during your resident period belongs in the declaration. AT may already have the data from international reporting frameworks.
Sorting portal access in June. Getting your AT password mailed or activating CMD for the first time takes days to weeks. Don't leave this until the last week of the filing window.
Using your NIF date or morada-fiscal change as your residency start. Both are common mistakes, and one of them circulates widely in expat groups ("I became a tax resident when I changed my NIF address"). Under CIRS Art. 16(3), residency starts from your first day of stay. If you arrived in March 2025, got your NIF in May, and updated your morada fiscal in June, your tax residency started in March. The administrative records don't decide it. CIRS Art. 16 does.
Assuming "I only arrived partway through the year" means a standard single filing. Partial-year residency under Art. 16(3) may require two Modelo 3 declarations for the same tax year. If your status changed mid-year, check whether Quadro 8C applies before filing.
Assuming the 12-month SS exemption means no IRS. Social Security and IRS are completely separate systems. The first-year SS exemption (12 months from activity start) means you didn't owe Social Security contributions during that period. It has no effect on whether you owe income tax or need to file.
Not filing because income was zero. If you opened activity and are resident, you file, even at €0.
Once you've confirmed you need to file, the IRS step-by-step guide covers the Portal das Finanças process: which annexes to complete, what the fields mean, how to simulate before submitting.
If you've missed the June 30 deadline, here's what that means practically, the fine is €200 and the interest is manageable if you file soon.
After you file, the IRS declaration reader translates your comprovativo into a plain-language breakdown of what was declared and where each number came from.
Descodify handles invoicing, VAT, and IRS reporting so you can focus on your work.
Try Descodify freeWorking for yourself in Portugal - monthly
Invoicing, VAT, Social Security, expenses, and tax, explained simply. One email a month.