Inspectable Arithmetic for the Canada Personal Income Tax Calculator

Version 1.2
Last verified: May 2026

Transparent arithmetic is the operating system of this calculator.

This document publishes the formulae, computational structure, and assumptions used to generate the outputs displayed on the calculator page.

No opinions. No hidden assumptions. Just arithmetic.

Purpose

This calculator estimates combined federal and provincial/territorial personal income tax for the selected tax year (2025 or 2026) in Canada. It models regular income, common investment income types, registered-account deductions, and payroll contributions, then reports total income tax, CPP/EI, average and marginal tax rates, and take-home pay by province or territory.

Definitions

Let:

• Y = tax year (currently 2025)
• P = province or territory of residence for tax purposes
• E = employment income
• S = self-employment (business) income
• O = other income (e.g., interest, rental, pension not modeled elsewhere)
• D_elig = eligible Canadian dividends (cash amount)
• D_ne = non-eligible Canadian dividends (cash amount)
• g_elig = gross-up rate for eligible dividends (e.g., 1.38)
• g_ne = gross-up rate for non-eligible dividends (e.g., 1.15)
• D_elig,gross = grossed-up eligible dividends
• D_ne,gross = grossed-up non-eligible dividends
• G = capital gains (cash amount)
• r_cg = capital gains inclusion rate (0.50 for 2025)
• G_taxable = taxable capital gains
• R_RRSP = RRSP deduction claimed this year
• R_FHSA = FHSA contribution deduction claimed this year
• D_est = other estimated deductions (user-entered)
• T_paid = federal + provincial/territorial income tax already paid for the year (from slips such as a T4 or RL-1 or from instalments); excludes CPP and EI
• CPP = Canada Pension Plan contributions (employee)
• EI = Employment Insurance premiums (employee)
• YMPE = Year’s Maximum Pensionable Earnings (base CPP)
• YAMPE = Year’s Additional Maximum Pensionable Earnings (upper bound for CPP2)
• BasicExemption = CPP basic exemption amount
• r_CPP = base CPP contribution rate
• MaxCPP1 = maximum base CPP contribution
• r_CPP2 = additional CPP (CPP2) contribution rate
• MaxCPP2 = maximum additional CPP contribution
• MaxInsurableEarnings = maximum EI insurable earnings
• r_EI = EI contribution rate
• MaxEI = maximum EI premium
• GI = gross income for tax (employment + business + other + grossed-up dividends + taxable capital gains)
• NI = net income (GI minus RRSP/FHSA/other deductions and line 22215 enhanced CPP deduction)
• TI = taxable income (NI in this calculator; no additional line 23400–26000 adjustments modeled)
• CPP_base = base CPP employee amount eligible for line 30800 credit
• CPP_enh = first additional CPP + CPP2 (line 22215 deduction from income)
• BPA_fed = federal Basic Personal Amount
• CEA = federal Canada Employment Amount
• c_fed = federal non-refundable credit rate (lowest federal bracket rate)
• r_CPP/EI,cred = CPP/EI credit rate (lowest federal tax bracket rate; 15% for 2025)
• DTC_elig,fed, DTC_ne,fed = federal dividend tax credits for eligible and non-eligible dividends
• DTC_fed = total federal dividend tax credit
• BPA_prov = provincial/territorial Basic Personal Amount
• c_prov = provincial non-refundable credit rate (configured or lowest provincial bracket rate)
• DTC_prov = provincial dividend tax credit
• Surtax_prov = provincial/territorial surtax
• Premiums_prov = additional provincial premiums (if any)
• Tax_fed = net federal income tax
• Tax_prov = net provincial/territorial income tax
• Tax_total = total income tax (federal + provincial)
• Burden_total = Tax_total + CPP + EI (total tax burden)
• R_IT = income tax balance: tax refund if positive, tax owing if negative (federal + provincial/territorial income tax only); R_IT = T_paid − Tax_total
• Income_gross = total cash income before tax
• ATI = after-tax income (take-home pay after income tax + CPP + EI)

Core Equations

1. Taxable Income

Dividend gross-up uses CRA-style rates from the internal dividends.json data file. Grossed-up dividends:

Taxable capital gains:

Gross income for tax and net income (T1 lines 15000 → 23600):

RRSP and FHSA are treated purely as deductions against income for the current year; contribution room, over-contribution penalties, and carry-forward rules are not modeled. CPP_enh is first additional CPP plus CPP2 (line 22215). EI is credit-only, not deducted from TI.

2. Federal Tax

Federal tax is computed using a standard bracket-and-credit structure derived from CRA parameters for 2025 (stored in federal.json).

Step 1 — bracket tax on TI:

Step 2 — non-refundable credits (Schedule 1 style):

• Basic Personal Amount: BPA_fed × c_fed
• Canada Employment Amount (if E > 0): CEA × c_fed
• Base CPP credit (line 30800): CPP_base × r_CPP/EI,cred
• EI credit: EI × r_CPP/EI,cred

Step 3 — federal dividend tax credit (DTC):

For each dividend type (eligible, non-eligible), the calculator computes a dividend tax credit using an explicit schema (base and rate) from dividends.json. The arithmetic is:

Step 4 — minimum tax adjustments (not modeled in 2025 engine):

3. Provincial / Territorial Tax

Provincial / territorial tax uses the same taxable income TI but parameters from the selected province or territory in provinces.json. Two flows exist: a generic flow for most provinces and an Ontario-specific flow that mirrors ON428 ordering and arithmetic.

3.1 Generic provinces

For provinces and territories other than Ontario:

1. Compute base bracket tax on TI using province-specific brackets and rates.
2. Subtract non-refundable credits (e.g., provincial Basic Personal Amount, using the configured credit rate or the lowest bracket rate).
3. Apply surtaxes, if any, to tax after credits.
4. Apply provincial dividend tax credit.
5. Apply provincial reductions or premiums (if configured).

3.2 Ontario-specific flow

Ontario follows ON428 ordering exactly:

1. Compute base bracket tax on TI.
2. Subtract Ontario non-refundable credits (Basic Personal Amount, etc.).
3. Compute surtax on tax after credits (with two tiers).
4. Add surtax.
5. Subtract Ontario dividend tax credit.
6. Add Ontario Health Premium based on TI.

4. CPP and EI (annual return, not payroll withholding)

Employee CPP uses CRA YMPE/YAMPE and rates in payroll.json (Schedule 8 / T4), not per-paycheque withholding tables.

CPP1 on earnings up to YMPE:

CPP2 between YMPE and YAMPE:

Total CPP:

EI:

5. Total Tax, Burden, and Take-Home Pay

Total income tax (federal plus provincial or territorial) before netting against income tax already paid:

Total tax burden including payroll contributions:

Total income before tax (cash income, including full capital gains amounts before inclusion):

Take-home pay after income tax and payroll:

Tax balance for income tax only (matches the result card; signed value; CPP and EI are not part of this line):

R_IT > 0 is shown as Income tax refund; R_IT < 0 is shown as Income tax owing (absolute value in the UI). T_paid is the “Income tax already paid (federal + provincial or territorial only)” input. CPP and EI appear only in Burden_total and take-home pay, not in R_IT.

6. Average and Marginal Tax Rates

Average tax rate (displayed as a percentage):

Income_gross reflects cash income (including the full capital gain amount before inclusion), not taxable income TI, so the displayed average rate may differ from CRA-style average rates that use taxable income as the denominator.

Marginal tax rate is computed using a $1 perturbation:

1. Compute baseline: Tax_baseline = Tax_total(inputs).
2. Choose an active income type (employment, then dividends, other income, or capital gains) based on which fields are non-zero.
3. Add $1 to that income type and recompute tax.

The engine uses unrounded bracket tax (no per-bracket rounding) for the marginal-rate perturbation, so the $1 change is not lost to rounding. If the combined marginal rate falls outside 0–100%, the calculator falls back to the first in-bounds marginal rate for an active income type.

Assumptions and Limitations

1. Tax year is fixed at 2025; only provinces and territories supported by the underlying data files are available.
2. RRSP and FHSA inputs are treated strictly as deductions; contribution room, over-contribution penalties, and carry-forward rules are out of scope.
3. Only common non-refundable credits are modeled (federal BPA, Canada Employment Amount, base CPP and EI credits, provincial BPAs and provincial base CPP/EI where configured, selected credits in data files).
4. Enhanced CPP (first additional + CPP2) is deducted from net income (line 22215); payroll withholding calculators that do not model the return split may disagree with this calculator.
5. Additional credits and deductions (medical expenses, tuition, donations, prior-year loss carryforwards, etc.) are not modeled individually; they can be approximated via the “Estimated Additional Deductions” field.
6. Dividend gross-up and tax credit rates come from federal and provincial data tables for 2025; province-specific nuances beyond the encoded schema are not modeled.
7. Capital gains use a fixed 50% inclusion rate for 2025 across all provinces.
8. CPP and EI are modeled from the employee perspective on employment income only, using official annual maximums and rates. Self-employment income is included in income for tax brackets but does not generate CPP or EI in v1 (no Schedule 8 self-employment path). Employer contributions are not included.
9. Quebec (QPP/QPIP), multiple employers, and Schedule 8 overpayment are out of scope for v1; see docs/SCOPE-v1.md.
10. Display rounding: Federal and provincial net income tax are each rounded to the nearest dollar for display; total income tax shown is the sum of those two rounded amounts. Internal tests compare unrounded form-trace values.
11. All amounts are in Canadian dollars; inflation, indexation beyond the configured year, and time value of money are not modeled in this calculator.
12. All calculations use full floating-point precision internally; rounding occurs only where required to mirror CRA per-bracket rounding and at the display layer.

Implementation Notes

• Federal, provincial, payroll, and dividend parameters are loaded from JSON data files and can be overridden for testing.
• Federal and provincial calculations follow the ordering and arithmetic of CRA Schedule 1 and provincial tax forms (e.g., ON428).
• Known-answer tests validate outputs against hand-computed or AI-assisted form calculations for representative scenarios.
• The “Show the Math” section on the calculator page surfaces bracket breakdowns, dividend gross-up details, and CPP/EI inputs using the same engine outputs described here.

If any discrepancy is identified between this documentation and the calculator output, the arithmetic here governs.

What This Calculator Does Not Include

• OAS clawback, GIS, and most benefit interactions.
• Alternative minimum tax (AMT) and detailed trust or partnership rules.
• Quebec-specific return mechanics beyond what the selected provincial file encodes.
• Full RRSP/FHSA room history, carryforwards, and over-contribution penalties — covered by the RRSP Contribution Room & Tax Refund Calculator, TFSA Contribution Room Calculator, TFSA Over-Contribution Penalty Calculator, and (for FHSA alongside TFSA and RRSP) the TFSA vs RRSP vs FHSA Calculator.
• Corporate integration beyond personal dividend taxation; see the CCPC Income Tax Calculator for corporate layers.

Sources and References

• Canada Revenue Agency (CRA)
• Government of Canada
• Statistics Canada
• Bank of Canada
• CMHC (housing and mortgage context, where relevant)
• OSFI (financial institution supervision, where relevant)
• SPIVA Canada (long-horizon fund performance context, where relevant)
• Robert Shiller — historical data (market and long-horizon data context, where relevant)