Moving states mid-year — part-year residency
Moving between states during a tax year splits your income between two residency stories: days as a resident of the old state, days as a resident of the new one — plus any wages sourced to a third state where your employer sits. Part-year residency is one of the most common real-world complications the module deliberately does not compute.
The three layers
Old state (part-year resident). You generally file a part-year resident return covering the period of residency, plus a nonresident return for income sourced there after you left — depending on the state's rules.
New state (part-year resident). Same structure in reverse: resident for the post-move period, potentially nonresident for income sourced there before arrival.
Employer state. Unaffected by your move — sourcing rules, convenience-of-the-employer rules and reciprocity agreements apply per pair, and a move can change which agreement (if any) covers you.
Domicile vs residence
"Where you live" for tax purposes is a facts-and-circumstances
determination — domicile involves intent, not just an address.
The module's partialResidency flag exists to mark that this
complexity is present; it does not attempt the allocation.
What v1 does and does not do
- Does: evaluate each state pair's rules (residence ↔
employer, residence ↔ work location) and emit a
partial_year_residency_not_modeledwarning. - Does not: prorate income, allocate days, or determine domicile — those need the states' part-year forms and often a professional.
Practical sequence
- Run the checker for your post-move residence/employer pair to see which rules apply going forward.
- Check both states' part-year resident instructions — each publishes its own convention for allocating income.
- File the required part-year and nonresident returns for the transition year.
FAQ
I moved in July — do I file two full-year returns?
No — each state has part-year resident mechanics. You file a part-year return in each state covering your respective periods, plus nonresident returns where income was sourced outside your residency periods. The exact allocation follows each state's published rules.
Does a reciprocity agreement still apply after I move?
It depends on the new pair. Agreements are between specific states — moving can create a covered pair, break one, or leave you uncovered entirely. Re-run the checker with the new residence state.
Why doesn't the tool prorate for me?
Because proration requires facts the tool does not collect — income timing, domicile intent, each state's allocation convention — and guessing would produce a wrong answer confidently. The warning tells you exactly where the modeling stops.