Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- Annual Salary (required)
-
Unit currency Default 90000 Range At least 0
About this input
Your gross annual pay, the base the deferral percentage and the match tiers are applied to.
- Catch Up Limit (required)
-
Unit currency/yr Default 7500 Range At least 0
About this input
The additional amount those at or above the catch-up age may defer. ILLUSTRATIVE, and changes annually.
- Elective Deferral Limit (required)
-
Unit currency/yr Default 23500 Range At least 0
About this input
The statutory limit on what you may defer in a year. ILLUSTRATIVE: it changes annually, so replace it with the current figure.
- Employee Age (required)
-
Unit years Default 40 Range 18 to 80
About this input
Your age this year. It decides only whether the catch-up amount is added to your deferral limit.
- Employee Deferral Percent (required)
-
Unit fraction Default 0.05 Range 0 to 1
About this input
The percentage of pay you defer into the plan. It is capped by the annual limit below before any match is worked out.
- Pay Periods Per Year (required)
-
Unit count Default 26 Range 1 to 52
About this input
How many times you are paid a year. Used only to express the annual contribution per paycheck.
- Tier 1 Match Rate (required)
-
Unit fraction Default 1 Range 0 to 2
About this input
The employer match on the first band of your deferral, expressed as a percentage. A 100% match is dollar for dollar.
- Tier 1 Up To Percent (required)
-
Unit fraction Default 0.03 Range 0 to 1
About this input
The top of the first band, as a share of your pay. "100% of the first 3%" is a rate of 1 and a ceiling of 3%.
- Tier 2 Match Rate
-
When omitted Blank
Unit fraction Default Not set Range 0 to 2
About this input
Optional. The rate on the second band. Leave both tier 2 cells blank if your plan has a single tier.
- Tier 2 Up To Percent
-
When omitted Blank
Unit fraction Default Not set Range 0 to 1
About this input
Optional. The top of the second band, as a share of pay. It is a cumulative ceiling, not a width: "then 50% of the next 2%" after a 3% first tier is a ceiling of 5%.
- Tier 3 Match Rate
-
When omitted Blank
Unit fraction Default Not set Range 0 to 2
About this input
Optional. The rate on a third band, for the few plans that have one.
- Tier 3 Up To Percent
-
When omitted Blank
Unit fraction Default Not set Range 0 to 1
About this input
Optional. The cumulative top of the third band, as a share of pay.
Outputs
- Contribution Limit
-
Unit currency/yr
About this output
What you may defer this year: the elective limit, plus the catch-up amount if you have reached the qualifying age.
- Deferral For Full Match
-
Unit fraction
About this output
The share of pay you would have to defer to capture every employer dollar available.
- Employee Contribution
-
Unit currency/yr
About this output
What you actually put in over the year, after the statutory cap is applied.
- Employer Match
-
Unit currency/yr
About this output
What the employer adds under its tiers, given what you defer.
- Immediate Return On Deferral
-
Unit fraction
About this output
Employer money per unit you defer. A dollar-for-dollar match on the whole of your deferral reads as 100 percent, before any investment return at all.
- Match As Percent Of Pay
-
Unit fraction
About this output
The employer match expressed as a share of your salary, which is how plans are usually compared.
- Match Left On Table
-
Unit currency/yr
About this output
Employer money you forfeit this year by deferring below the top of the match tiers. It is not recoverable later.
- Maximum Employer Match
-
Unit currency/yr
About this output
The most the plan would ever add, whatever you defer. The gap between this and the line above is the number this calculator exists for.
- Model Status
-
No unit declared
About this output
Reads OK, or explains why the inputs are not valid or why the answer deserves a second look.
- Per Paycheck Contribution
-
Unit currency
About this output
That annual figure divided by your pay periods, which is what you will see on a payslip.
- Total Annual Contribution
-
Unit currency/yr
About this output
Everything going into the plan this year, yours and the employer's together.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.
Methodology
Purpose and model boundary
Use this calculator to translate a tiered employer-match formula into dollars. It shows the match earned at your chosen deferral, the deferral needed for the full match, and the employer contribution missed when you defer less.
The calculation covers match bands and the annual employee-deferral cap. It excludes vesting, true-up provisions, nondiscrimination testing, after-tax or Roth subaccounts, loans and investment growth.
Inputs and units
| Input | Unit | Accepted range | What it means |
|---|---|---|---|
| Tier 2 Match Rate | percentage | 0–200% | Optional. The employer match percentage on the second band. Leave both tier 2 inputs blank if your plan has one tier. |
| Tier 1 Up To Percent | percentage | 0–100% | The cumulative percentage of pay at the top of the first band. “100% of the first 3%” uses a 100% match and a 3% ceiling. |
| Tier 1 Match Rate | percentage | 0–200% | The employer match percentage on the first band. A dollar-for-dollar match is 100%. |
| Tier 3 Up To Percent | percentage | 0–100% | Optional. The cumulative percentage of pay at the top of the third band. |
| Tier 3 Match Rate | percentage | 0–200% | Optional. The employer match percentage on a third band. |
| Tier 2 Up To Percent | percentage | 0–100% | Optional. The cumulative percentage of pay at the top of the second band, not the band's width. For example, “50% of the next 2%” after a first tier ending at 3% has a 5% ceiling. |
| Elective Deferral Limit | $/year | 0 or more | The statutory limit on what you may defer in a year. ILLUSTRATIVE: it changes annually, so replace it with the current figure. |
| Catch Up Limit | $/year | 0 or more | The additional amount those at or above the catch-up age may defer. ILLUSTRATIVE, and changes annually. |
| Annual Salary | $ | 0 or more | Your gross annual pay, the base the deferral percentage and the match tiers are applied to. |
| Pay Periods Per Year | count | 1 to 52 | How many times you are paid a year. Used only to express the annual contribution per paycheck. |
| Employee Deferral Percent | percentage | 0–100% | The percentage of pay you defer into the plan. The annual deferral limit is applied before the employer match is calculated. |
| Employee Age | years | 18 to 80 | Your age this year. It decides only whether the catch-up amount is added to your deferral limit. |
Governing relationships
Each tier pays its match percentage only on the employee deferral that falls inside that band. For tier k, the matched share of pay is max(0, min(deferral, ceiling_k) - ceiling_(k-1)), with the first tier starting at zero. Summing all tiers at the highest ceiling gives the maximum plan match. The employee deferral is limited to the elective limit plus any age-qualified catch-up amount before the match is calculated.
Calculation sequence
- Read the salary, the deferral percentage, the pay periods, the employee age, the plan limits and the three tier ceilings and rates.
- Determine the deferral cap as the elective limit, plus the catch-up amount once the qualifying age is reached.
- Convert the deferral percentage into an amount and cap it at the deferral limit, recording whether the cap bound before the plan's own ceiling did.
- For each tier in order, apply the tier rate to the portion of pay between the previous ceiling and that tier's ceiling, bounded by the actual deferral.
- Sum the tiers to get the employer match.
- Repeat the same sum evaluated at the top ceiling to get the plan maximum, and subtract the match earned to get the amount left on the table.
- Solve for the deferral percentage at which the whole match is captured.
- Evaluate the status in the order given below.
Outputs and interpretation
The headline figures are Match Left On Table, Deferral For Full Match and Employer Match. Everything else is supporting detail for those.
| Output | Role | Unit | What it means |
|---|---|---|---|
| Match Left On Table | headline | $/year | Employer money you forfeit this year by deferring below the top of the match tiers. It is not recoverable later. |
| Deferral For Full Match | headline | percentage | The percentage of pay you must defer to capture the full available employer match. |
| Employer Match | headline | $/year | What the employer adds under its tiers, given what you defer. |
| Maximum Employer Match | detail | $/year | The most the plan would ever add, whatever you defer. The gap between this and the line above is the number this calculator exists for. |
| Total Annual Contribution | detail | $/year | Everything going into the plan this year, yours and the employer's together. |
| Per Paycheck Contribution | detail | $ | That annual figure divided by your pay periods, which is what you will see on a payslip. |
| Match As Percent Of Pay | detail | percentage | Employer match as a percentage of salary, which makes plans easier to compare. |
| Contribution Limit | detail | $/year | What you may defer this year: the elective limit, plus the catch-up amount if you have reached the qualifying age. |
| Employee Contribution | detail | $/year | What you actually put in over the year, after the statutory cap is applied. |
| Immediate Return On Deferral | detail | percentage | Employer money as a percentage of your deferral. A dollar-for-dollar match reads as 100% before any investment return. |
Validation and status logic
The workbook evaluates status in this order, and the first condition that is true wins. The status text below is the exact wording the workbook returns; angle brackets mark a value substituted into the message at calculation time.
| Condition | Returned status |
|---|---|
| Annual Salary <= 0 | NOT VALID: there is no salary to defer from |
| Pay Periods Per Year < 1 | NOT VALID: there has to be at least one pay period a year |
| Employee Deferral Percent < 0 | NOT VALID: the deferral cannot be negative |
| Tier 1 Match Rate < 0 | NOT VALID: a match rate cannot be negative |
| AND(Tier 2 Match Rate <> "",Tier 2 band width <= 0) | CHECK: the tier 2 ceiling is at or below the tier 1 ceiling, so tier 2 pays nothing. These ceilings are CUMULATIVE: 100% on the first 3% then 50% on the next 3% is a tier 2 ceiling of 6%, not 3% |
| AND(Tier 3 Match Rate <> "",Tier 3 band width <= 0) | CHECK: the tier 3 ceiling is at or below the tier 2 ceiling, so tier 3 pays nothing. These ceilings are cumulative |
| Match Left On Table > 0 | CHECK: deferring <deferral for full match> would capture the whole match; you are forfeiting employer money |
| Is the deferral at the statutory cap? = 1 | CHECK: your deferral is capped by the annual limit before the plan's own ceiling |
| None of the preceding conditions applies | OK |
Where a message substitutes a value, these are the exact returns the delivered corpus records:
CHECK: deferring 100.0% would capture the whole match; you are forfeiting employer moneyCHECK: deferring 3.0% would capture the whole match; you are forfeiting employer money
Assumptions and limitations
- Tier ceilings are cumulative shares of pay, not separate bands each measured from zero. One hundred percent on the first three percent then fifty percent on the next three percent is a tier 2 ceiling of six percent, not three.
- The elective deferral limit and the catch-up amount are inputs. They are illustrative values you supply and must be checked against the limits for the year in question.
- Salary is level across the year and the deferral is a constant share of every pay period.
- Vesting, true-up and plan-specific eligibility rules are outside the model, so an earned match is not necessarily a match you keep.
Restrictions and non-computing states
The salary must be greater than zero. Tier ceilings are cumulative and must increase: a tier whose ceiling is at or below the previous tier's pays nothing, and the workbook reports that rather than silently ignoring it. Pay periods must be at least one. The deferral percentage, tier rates, elective limit and catch-up amount are held within their published ranges. Where the annual deferral limit binds before the plan's top ceiling, the full match cannot be captured at any percentage and the workbook says so.
Errors and warnings
A rejected entry means a value fell outside the published input rules, and no calculation was attempted. Workbook NOT VALID means the model ran and could not produce a meaningful answer, so the results are withheld. Workbook CHECK means the numbers stand but a condition is worth reading before you rely on them. A connection or calculation-service failure is an availability problem, not a finding of any kind, and never means zero.
References
Elective deferral limits and catch-up contributions are set by the Internal Revenue Service; see 401(k) and profit-sharing plan contribution limits and catch-up contributions. The workbook reproduces neither: both limits are editable inputs, and the band arithmetic is derived in the delivered audit.
This model is arithmetic. It is not financial, tax, investment or retirement advice, and it is not a recommendation to save, invest, withdraw, claim or accept any amount. Decisions about retirement funding should be taken with a qualified professional who knows your circumstances.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.