What it models

The engine keeps a residency timeline for each person, taxes what each country is entitled to tax, relieves double tax by treaty or credit, and shows the result by country and by reason. It covers 12 countries with national tax models, and cross-border results are byte-identical to single-country results for any plan that never moves and holds nothing abroad.

The residency timeline and split years

Each person starts resident where the household is. You add moves to the plan: a month, a country and region, and whether it is one of you or both. A milestone can also carry a "relocate" effect, such as moving back home when you retire. Partners can live in different countries. You can also record where you lived before the plan starts, which the UK look-back tests need.

A move part-way through a tax year splits it. Each country taxes its share of the year by months, and pay is taxed by the country you live in while you earn it: pay stops in the old country at the move. The real UK split-year treatment, which can keep a full personal allowance, is approximated by this proration.

Tax on income from a country you have left

The country you live in taxes your worldwide income. A country where something is located may also tax it as a non-resident. Each account, property, debt and income has a country, defaulting to your household's, and it does not change when you move: a UK pension stays a UK pension.

  • United Kingdom (detailed). Non-residents keep the personal allowance only if entitled (British or EEA citizens, or by treaty). Non-resident capital gains tax applies to UK property from the April 2015 or April 2019 value. The model also covers ISAs and pension rules.
  • United States (basic). US citizens and green-card holders pay US tax on worldwide income wherever they live, after the foreign earned income exclusion (prorated by months abroad) and a foreign tax credit, in one basket without carry-forward. A US person abroad pays federal tax only, not state tax.
  • Canada, Australia, Spain, the UAE and the others (basic). Country-specific rules for pay, rent, property gains and some withholding, not every condition. Where a rule is missing, the resident rates are used.

Treaty relief

The residence country credits tax paid to the source country, limited to its own tax on the same income, so nothing is taxed twice. Treaties decide who keeps the right to tax each kind of income.

  • UK-UAE is the detailed one, implemented from the 2016 convention article by article (Articles 4, 6, 10, 11, 13, 14, 17, 18, 20 and 21): pay is taxed where the work is done; private pensions, interest and dividends only in the country of residence; the State Pension under the pensions article (residence only); government pensions in the paying state; rent and property gains where the property is; other gains and other income in the country of residence. The convention was signed on 12 April 2016 and has effect from 2017.
  • Basic treaties cover UK-US, UK-Australia, UK-Canada, UK-Spain, UK-France and US-Canada. They record the main allocation rules, not each article, and some rows are marked "not verified" and use the credit method.
  • Any other pair falls back to both countries taxing under domestic law with a credit in the country of residence, and Glideworth shows a warning.

Treaty relief is assumed claimed, for example with a form such as HMRC's DT-Individual; until it is, the source country may deduct tax.

Leaving and arriving

  • Departure tax. Leaving Canada triggers a deemed sale of taxable investment accounts, and leaving Australia triggers capital gains tax event I1. Both are taxed on the value at the start of the year you leave, and you can model the deferral elections. Registered plans, such as an RRSP or a TFSA, are excluded.
  • Arrival rebasing. Arriving in Canada or Australia resets the cost of your investments to market value without tax.
  • Wrappers. You cannot pay into a UK ISA while you live abroad, from the tax year after you leave. UK pension contributions get relief on up to £3,600 gross for five tax years after leaving, then stop. Canadian TFSA and RRSP contributions stop. A new country may not recognise a foreign tax-free account, so by default Glideworth taxes the growth when you take money out.
  • Exchange rates. Tax in each country is worked out in its currency with your rate table. Add a rate for every currency involved; a missing rate is a warning and treated as 1.

UK temporary non-residence, State Pension and inheritance tax

  • Temporary non-residence. If you were UK resident in four of the seven tax years before leaving and are away for five years or less, gains you realise abroad are taxed in the year you return. This covers capital gains only, not pension lump sums.
  • Frozen State Pension. The UK State Pension is uprated each year in the EEA, Switzerland and some other countries, and frozen at the rate first paid where it is not (the UAE, Canada, Australia and others). It goes back to the current rate if you return. An audit finding tells you when you are short of qualifying years and what voluntary Class 3 contributions would cost: £18.40 a week in 2026-27, needing ten years of UK residence or ten qualifying years. From 2026-27 you cannot pay Class 2 for time abroad.
  • Inheritance tax. From 6 April 2025, someone UK resident in at least 10 of the previous 20 tax years is a long-term resident, and their worldwide estate is in scope. After you leave, it stays in scope for 3 to 10 tax years, depending on how long you lived in the UK; after that, only UK assets.

What you enter yourself

Glideworth does not decide your status. You enter:

  • Residence over time, since there is no statutory residence test, 183-day rule or tie-breaker.
  • Citizenships and any US green card, where you lived before the plan, and state-pension records with qualifying years and voluntary years you plan to buy.
  • The country of each account, property, debt and income.
  • Exchange rates for each currency involved.
  • Voluntary contributions as an expense yourself; they are not added automatically.
  • A gratuity or bonus paid after you move is taxed where you then live. The end-of-service gratuity is UAE-only.

Stay or move?

The stay-or-move comparison runs two deterministic projections, one where you stay and one where you move, and shows the plan changes, the lifetime tax by country and reason, and where the difference in your final wealth comes from. It is deterministic, not a chance of success: branch the plan to run Monte Carlo on each.

Where each part is today

The engine models all of the above. The web app has screens for most of it, and the API and MCP server expose the rest.

WhatIn the web appThrough the API and MCP
Residency timeline and movesPlan editor, "Where you live", and a "Relocate" effect on milestonesResidency routes under a plan; get_residency_timeline, propose_move
Cross-border switches (rules on or off, departure tax, UK temporary non-residence, State Pension freeze)Plan editor, "Where you live"Plan tax settings
Citizenship, past residence, state-pension recordsCurrent finances, "About you", "Citizenship, past residence and state pension"A per-person cross-border record; set_person_cross_border
Country of an account, property, debt or incomeA "Country" field on each. Planned real assets and plan-level account overrides have no country field in the plan editor: set it on the item in Current financesCross-border items routes
Tax by country and reason; "How this is taxed, and why"Taxes page and the Results year drill-down. The bracket and marginal-rate analytics on the Taxes page describe the household country's calculation onlyTax breakdown by country; tax_by_country, explain_item_taxation
Stay or move, and the relocation what-ifInsights, "Stay or move?"A stay-or-move insight; compare_stay_or_move; a relocation template
Rule tables (non-resident rules, treaties)Appear in "How this is taxed, and why", with the treaty article and its source, and as warningsCross-border rule tables; cross_border_rules

Tables and tax years

UK non-resident rules are for 2026-27 (gov.uk). UK inheritance tax long-term residence is from 6 April 2025. Voluntary National Insurance is for 2026-27 and the US foreign earned income exclusion for 2025 and 2026. Each country's own tables are on its country page.

Questions

Does Glideworth tell me which country I am tax resident in?

No. Residence is what you enter: you are resident where your timeline says. Glideworth applies no statutory residence test, no 183-day rule and no treaty tie-breaker, so decide your status first (with a professional if it is unclear) and then model it.

Which countries have the most detailed treatment?

The United Kingdom for non-resident rules, and the UK-UAE treaty, which is implemented article by article. The United States, Canada, Australia, Spain, the UAE and the other countries have basic non-resident rules, and the other treaties are basic.

Can I do all of this in the web app?

Most of it, yes: the app has screens for the residency timeline, citizenship and past residence, a country on each item, tax by country, and a stay-or-move comparison. A few items are set differently or only through the API; they are listed on this page.

What if my plan never moves?

Nothing here runs. A household that never moves and holds nothing abroad gets the same results as before the model existed; the engine checks this with a regression suite of 31 households.

Official sources

See where your plan lands.

Free to self-host today, with every feature. The hosted service opens later, at $9 a month or $90 a year.