How this instrument works
The Child Tax Credit knocks $2,000 off a family's federal tax bill for each qualifying child under 17 at year-end, claimed on Schedule 8812 and rooted in Section 24 of the tax code. The figure has not always been $2,000: it doubled from $1,000 under the 2017 Tax Cuts and Jobs Act, and the $200,000/$400,000 thresholds used here replaced older $75,000/$110,000 limits at the same time. That structure has since been extended rather than left to lapse on its original schedule, so the numbers in this instrument reflect current law, not the pre-2018 credit some older calculators still show.
Above the threshold, the credit shrinks by $50 for every $1,000 of income past it — a flat 5% marginal rate baked into the statute, chosen so the credit fully disappears a fixed distance above the line rather than trailing off indefinitely. A single parent of two loses the entire $4,000 credit by $280,000 of income; a two-child couple filing jointly loses it by $480,000. The Internal Revenue Service actually rounds the excess up to the next full $1,000 before applying that $50, producing a staircase rather than a ramp; this instrument computes the reduction continuously, so a figure sitting a few dollars past a $1,000 boundary can differ from the IRS number by up to $50.
This instrument stops at the gross credit before two further checks the real filing applies: the refundable Additional Child Tax Credit is capped well under $2,000 per child and tied to earned income above $2,500, and every child must carry a Social Security number valid for employment — a child with only an ITIN falls back to the separate $500 credit for other dependents. A tax preparer sanity-checking software, a two-earner household watching a bonus or vested stock push income toward the ceiling, and a planner weighing pretax retirement contributions against the threshold all read this figure for different reasons, but none of them get a refund estimate or a recommendation from it — only the pre-refundability arithmetic.
- Enter the count in Qualifying children under 17 — only children who are under that age at year-end count.
- Type your Household income, $ — the figure the phase-out formula measures against the threshold.
- Set Married filing jointly (1=yes, 0=no) to 1 for a joint return, 0 for single, head of household, or separate filing.
- Read Phase-out threshold to see whether it locked at $400,000 or $200,000 for your filing status.
- Read Total Child Tax Credit for the dollar amount that survives the phase-out at your income and family size.
Worked example — two children, $150,000, filing single
A single filer enters two qualifying children, $150,000 of household income, and leaves Married filing jointly at 0 (numChildren = 2, income = $150,000, filingJoint = 0). Because the filer isn't joint, the threshold locks at $200,000 rather than $400,000 — the formula reads if(filingJoint>0.5, 400000, 200000), and 0 fails that test.
Two children set the maximum at 2 × $2,000 = $4,000. Income of $150,000 sits $50,000 below the $200,000 threshold, so max(0, 150000 − 200000) evaluates to zero and no phase-out applies: the family keeps the full $4,000. Nudge income to $210,000 instead and the excess of $10,000 costs 10 × $50 = $500, dropping the credit to $3,500 — the same formula, just past the line.
Questions
Why is the joint threshold exactly double the single one?
The Tax Cuts and Jobs Act set the joint threshold at $400,000 and every other filing status at $200,000 starting in 2018, replacing older limits of $110,000 and $75,000 that were closer together. Doubling the joint figure avoided a sharp marriage penalty for two-earner households near the line — a couple earning what two $200,000 single filers would each earn separately keeps the full credit either way.
Why does the IRS reduce my credit in $50 jumps instead of a smooth line?
The IRS rounds the excess over the threshold up to the next full $1,000 before applying the $50 reduction, so income of $200,100 and $200,999 cost the same $50 — a staircase, not a ramp. This instrument applies the $50 continuously per $1,000 of excess for a cleaner read across the full income range; near a $1,000 boundary its figure can sit a few dollars from the IRS number, never more than $50.
Will I actually receive this full amount as a refund?
Not necessarily. This figure is the credit before the refundable Additional Child Tax Credit rules apply — the refundable portion is capped per child, well under $2,000, and limited to a share of earned income above $2,500. A family with little tax liability and modest earned income can owe less than this number back to them even though the credit itself computes correctly.
What if my child turned 17 during the year?
They stop qualifying for this credit. Eligibility is tested at December 31 of the tax year, not at filing time, so a child who turns 17 anytime during the year drops out of the $2,000 count entirely — though they may still qualify a parent for the separate, smaller $500 credit for other dependents.
Does a lower Adjusted Gross Income change the result?
Yes, because the threshold tests against income, and pretax contributions to a 401(k), traditional IRA, or HSA reduce Adjusted Gross Income before this formula ever sees it. This instrument takes whatever figure you type at face value; it doesn't calculate how a specific contribution changes that figure, only the credit that results once you enter the adjusted number.
References
Read this first: This instrument shows arithmetic, not advice. Real offers add fees, taxes and terms that vary by lender and place — verify the figures against your actual paperwork before deciding anything.