{
  "id": "retirement-calculator",
  "version": "20.1.0",
  "name": "Retirement Calculator",
  "shortName": "Retirement",
  "description": "Project retirement savings and compare them with an optional income target.",
  "category": "Finance",
  "categorySlug": "finance",
  "keywords": [
    "retirement savings",
    "nest egg",
    "monthly contribution",
    "withdrawal rate"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/retirement-calculator.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "20.1.0",
    "referenceCoverage": "references-listed",
    "releaseTestScope": "Flagship reference cases are specified in scripts/test-v20-1.mjs; consult release evidence for executed results.",
    "historicalMetadataDate": "2026-08-18",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "notice": "Planning estimate only. Investment returns are not guaranteed.",
  "urls": {
    "page": "/calculator/retirement-calculator/",
    "definition": "/calculator/retirement-calculator/definition.json",
    "schema": "/calculator/retirement-calculator/schema.json",
    "llms": "/calculator/retirement-calculator/llms.txt",
    "legacyDefinition": "/calculator/retirement-calculator.json"
  },
  "queryExample": "https://askcalculators.com/calculator/retirement-calculator/?currentAge=35&retirementAge=65&currentSavings=50000&monthlyContribution=800&annualReturn=7&withdrawalRate=4",
  "queryParameters": {
    "currentAge": {
      "label": "Current age",
      "type": "number",
      "required": true,
      "default": 35
    },
    "retirementAge": {
      "label": "Retirement age",
      "type": "number",
      "required": true,
      "default": 65
    },
    "currentSavings": {
      "label": "Current retirement savings",
      "type": "money",
      "required": true,
      "default": 50000
    },
    "monthlyContribution": {
      "label": "Monthly contribution",
      "type": "money",
      "required": true,
      "default": 800
    },
    "annualReturn": {
      "label": "Annual return",
      "type": "percent",
      "required": true,
      "default": 7
    },
    "targetAnnualIncome": {
      "label": "Target annual retirement income",
      "type": "money",
      "required": false
    },
    "withdrawalRate": {
      "label": "Withdrawal rate",
      "type": "percent",
      "required": true,
      "default": 4
    }
  },
  "inputs": [
    {
      "id": "currentAge",
      "label": "Current age",
      "type": "number",
      "required": true,
      "defaultValue": 35,
      "min": 18,
      "max": 100,
      "step": 1,
      "width": "half"
    },
    {
      "id": "retirementAge",
      "label": "Retirement age",
      "type": "number",
      "required": true,
      "defaultValue": 65,
      "min": 19,
      "max": 100,
      "step": 1,
      "width": "half"
    },
    {
      "id": "currentSavings",
      "label": "Current retirement savings",
      "type": "money",
      "required": true,
      "defaultValue": 50000,
      "min": 0,
      "step": 1000,
      "width": "half"
    },
    {
      "id": "monthlyContribution",
      "label": "Monthly contribution",
      "type": "money",
      "required": true,
      "defaultValue": 800,
      "min": 0,
      "step": 50,
      "width": "half"
    },
    {
      "id": "annualReturn",
      "label": "Annual return",
      "type": "percent",
      "required": true,
      "defaultValue": 7,
      "min": 0,
      "max": 30,
      "step": 0.1,
      "control": "slider-number",
      "width": "half"
    },
    {
      "id": "targetAnnualIncome",
      "label": "Target annual retirement income",
      "type": "money",
      "min": 0,
      "step": 1000,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "withdrawalRate",
      "label": "Withdrawal rate",
      "type": "percent",
      "required": true,
      "defaultValue": 4,
      "min": 0.1,
      "max": 20,
      "step": 0.1,
      "width": "full"
    }
  ],
  "outputs": [
    {
      "id": "projectedSavings",
      "label": "Projected retirement savings",
      "format": "currency",
      "primary": true
    },
    {
      "id": "totalContributions",
      "label": "Total contributions",
      "format": "currency"
    },
    {
      "id": "investmentGrowth",
      "label": "Investment growth",
      "format": "currency"
    },
    {
      "id": "targetNestEgg",
      "label": "Target nest egg",
      "format": "currency"
    },
    {
      "id": "surplusGap",
      "label": "Surplus or gap",
      "format": "currency"
    }
  ],
  "formula": {
    "expression": "Balanceₙ = balanceₙ₋₁ × (1 + annual return/12) + monthly contribution",
    "note": "The optional target nest egg equals annual income divided by the withdrawal rate."
  },
  "examples": [
    {
      "label": "Reproducible default-input example (not a personal recommendation)",
      "inputs": {
        "currentAge": 35,
        "retirementAge": 65,
        "currentSavings": 50000,
        "monthlyContribution": 800,
        "annualReturn": 7,
        "withdrawalRate": 4
      }
    }
  ],
  "sources": [
    {
      "label": "Investor.gov: compound-interest calculator and assumptions",
      "url": "https://www.investor.gov/financial-tools-calculators/calculators/compound-interest-calculator"
    }
  ]
}