Skip to main content

Methodology

Employer Retirement Match Value Calculator methodology

Estimate stated employer match value and the portion expected to be vested.
Duc Nguyen X.By Duc Nguyen X.· Founder, Wage101Last reviewed: View update historyMethodology

Educational only: Work and pay decision support, not tax, legal, financial or career advice.

Privacy: Calculations run locally; Wage101 does not receive your work or pay inputs.

Update policy: Reviewed when formulas or official dependencies change.

Scope: Market-neutral work and pay planning using your own assumptions.

1. Formulas and units

Employer match
employerMatchAnnual = min(eligibleAnnualPay × min(employeeRate, eligibleRate) × matchRate, cap)

Where

eligibleAnnualPay
Eligible annual pay (currency units/year)Source: Work record
employerMatchAnnual
Annual employer match (currency units/year)Source: Calculated output
Vested annual match
vestedEmployerMatchAnnual = employerMatchAnnual × vestedRate

Where

vestedRate
Vested share (decimal rate)Source: User assumption
vestedEmployerMatchAnnual
Vested annual match (currency units/year)Source: Calculated output
Employee annual contribution
employeeContributionAnnual = eligibleAnnualPay × employeeContributionRate

Where

eligibleAnnualPay
Eligible annual pay (currency units/year)Source: Work record
employeeContributionRate
Employee contribution rate (decimal rate)Source: User decision
employeeContributionAnnual
Employee annual contribution (currency units/year)Source: Calculated output
Contribution rate for full match
employeeContributionRateForFullMatch = employerMatchRate = 0 ? 0 : min(matchEligiblePayRate, annualEmployerCap ÷ (eligibleAnnualPay × employerMatchRate))

Where

eligibleAnnualPay
Eligible annual pay (currency units/year)Source: Work record
employerMatchRate
Employer match rate (decimal rate)Source: Work record
matchEligiblePayRate
Eligible pay contribution limit (decimal rate)Source: Work record
annualEmployerCap
Annual employer cap (currency units/year)Source: Work record
employeeContributionRateForFullMatch
Contribution rate for full match (share of eligible pay)Source: Calculated output

Money inputs and outputs use the currency selected in the scenario without changing the canonical methodology. Pay, time, benefits and work-related costs use the units stated beside each input.

2. Worked example

Input assumptions

Eligible pay of 80,000, a 6% contribution, 50% match, 2,000 cap and 80% vested share.

Calculation and outputs

Example

Eligible pay of 80,000, a 6% contribution, 50% match, 2,000 cap and 80% vested share.

Annual employer match
2,000.00 currency units
Vested annual match
1,600.00 currency units
Employee annual contribution
4,800.00 currency units
Contribution rate for full match
5%

The entered plan cap and vesting share are kept visible in the annual value.

Interpretation

Use the vested match as the scenario value when vesting is not yet complete.

3. Validation and boundary checks

  • The match never exceeds the uncapped match.
  • The vested value never exceeds the match.
  • Rates outside zero to one return an input error.

4. Assumptions and source classification

  • All plan terms are user-entered.
  • The cap is treated as an annual amount.
  • No tax or withdrawal rule is applied.

This calculator has no current policy-data dependency. Its work and pay assumptions are user supplied. Registered family-level regression suites exercise the shared work-logic engine and worked-result reconciliation.

5. Limitations

  • Plan definitions and vesting rules vary.
  • The tool does not verify eligibility.
  • Investment returns are excluded.

This is educational decision support, not personalised tax, legal, financial or career advice. Check the treatment of your circumstances under the rules that apply to you and seek qualified advice where appropriate.

6. Update and evidence policy

Registered family-level suites test formula invariants and example reconciliation; the release ledger records that coverage without claiming a separate oracle for every line of public copy. There is no official threshold or benchmark to refresh for this calculator. Work and pay inputs remain user-supplied because they vary by person, job and contract.

Change history

  1. : Initial public release of the Employer Retirement Match Value planner and methodology.

Related reading

Use these practical guides to interpret the decision and its assumptions.

Return to the calculator