The math: how much change to hit safe?
Water change dilutes whatever's in the tank by the percent changed (assuming tap water is at 0). To go from current ppm down to target ppm in a single change:
change_fraction = 1 − (target_ppm / current_ppm)
Example: ammonia at 2 ppm, fish-in target 0.25 ppm → 1 − (0.25/2) = 0.875, so an 87.5% change in a single shot. That's past the safe single-change threshold — the calculator caps the immediate change at 50% and tells you to repeat.
Severity tiers (fish-in tank)
- ≤ 0.25 ppm — OK. Standard target. No action.
- 0.25–1 ppm — watch (1× tank dose).Stressing fish but not acutely toxic. 30–50% water change soon + Prime 1× on full tank volume (Seachem's standard tier).
- ~2 ppm — act now (2× tank dose).Significant stress, gill damage on prolonged exposure. Immediate water change + Prime 2× on full tank volume per Seachem's tiered dosing table.
- ~3 ppm — act now (3× tank dose). Increasing urgency. Water change + Prime 3× on full tank volume.
- ~4 ppm — extreme (4× tank dose). Life-threatening for stocked fish. Staged water changes (50% now, repeat after retest) + Prime 4× on full tank volume.
- ≥ 5 ppm — extreme (5× tank dose, Seachem ceiling). Life-threatening. Staged water changes + Prime 5× on full tank volume. Stop feeding. If fish are gasping at the surface or lying belly-up, you may not save them — surface gasping is also an O₂-supply symptom and adding supplementary aeration can buy minutes while the water change runs.
Prime dose follows Seachem's tiered table.The calculator scales the multiplier with the test reading: ~1 ppm → 1×, ~2 ppm → 2×, ~3 ppm → 3×, ~4 ppm → 4×, ~5 ppm and above → 5× (the maximum/emergency ceiling). Seachem's FAQ notes 5× is an optional ceiling above 2 ppm; defaulting every 2+ ppm reading to 5× is more dose than the published table prescribes at the lower end of that range. Doses are calculated on full aquarium volume per Seachem's emergency ammonia/nitrite guidance — not just the new water added during the change.
Why staged changes instead of one giant change
A 90% water change in a single shot is the kind of fix that looks right on paper and kills fish in practice. The new water carries slightly different pH, temperature, and trace mineral content than the tank — and dropping a fish from a stable 78°F + pH 7.4 environment into a fresh 72°F tap-temp + pH 7.0 mix can shock them harder than the ammonia they're recovering from. Staged changes (50% at a time, with retesting between) get to the same end state with much smaller incremental swings.
The 50% threshold isn't magic. It's the conservative tradeoff between diluting the toxin enough to matter and shifting too many other variables at once. Hobby consensus puts the safe single-change ceiling at 50-80% depending on baseline stability.
What this calculator does NOT model
- pH-dependent toxicity. Ammonia exists as toxic free NH₃ above pH 7.5 and as less-toxic NH₄⁺ below. A 1 ppm reading at pH 8.2 is much more dangerous than at pH 6.8. The calculator targets a single ppm threshold; if your tank pH is above 7.5, treat readings as worse than displayed.
- Tap water with non-zero ammonia. If your municipal water has measurable ammonia (from chloramine treatment, ag runoff, etc.), the achievable target is bounded by the tap. Test your tap water and adjust expectations.
- Bound vs free ammonia after Prime dosing.Prime binds ammonia for 24-48 hours; standard test kits read total ammonia including bound form. A "1 ppm" reading post-Prime may be mostly bound + safe; a 1 ppm reading with no recent Prime is mostly free + dangerous. If unsure, assume the worst case.
- Veterinary diagnosis.Severe symptoms (heavy gasping, fin clamping, refusing food after the spike) may indicate secondary infection or organ damage that water changes alone won't fix. Talk to an aquatic veterinarian or qualified local aquarium professional.
FAQ
My ammonia is at 1 ppm. Is my fish going to die?
Probably not in the short term, but it's actively stressing them and prolonged exposure causes gill damage. The standard fish-keeping target is ammonia under 0.25 ppm — the calculator targets that. At 1 ppm you should do a 75% water change immediately and re-test in 30 minutes. If you're seeing fish gasping at the surface, behavioral lethargy, or gill flaring, you're past the watch threshold and into urgent territory regardless of the exact number.
Why does the calculator recommend staged changes instead of one big change?
Two reasons. First, a single 90%+ water change introduces significant pH and temperature swings that shock fish — sometimes worse than the ammonia exposure they're recovering from. Second, the new water needs to mix and be tested before you decide on round 2. The staged approach: 50% now, retest in 30 minutes, repeat until you're at target. The math gets you to the same end-state as a single huge change, with much less risk of secondary shock.
Should I use an ammonia-binder like Prime instead of a water change?
Both. Seachem Prime binds free ammonia for 24-48 hours so the bacterial colony has time to consume it, but it doesn't actually REMOVE ammonia from the water — your test kit may still show a positive reading because it measures total ammonia (bound + free). The water change physically removes the toxin. Best practice: water change first to drop the absolute amount, then dose Prime into the aquarium based on FULL TANK volume — not just the new water — per Seachem's emergency ammonia/nitrite guidance. The Prime multiplier follows Seachem's tiered dosing table by toxin concentration: ~1 ppm uses 1× (standard, 1 mL / 10 gal), ~2 ppm uses 2×, ~3 ppm uses 3×, ~4 ppm uses 4×, and ~5 ppm or above uses 5× (the maximum/emergency ceiling). Seachem's FAQ notes 5× is an optional ceiling above 2 ppm — the calculator uses the tiered table by default. Prime alone is a stopgap, not a substitute for a water change when fish are stressed.
I'm doing a fishless cycle and my ammonia is at 6 ppm. Is that bad?
Yes — high ammonia (above ~5 ppm) inhibits Nitrosomonas, the bacteria you're trying to grow. They grow best in the 1-4 ppm range. If you've over-dosed, do a 25-50% water change to bring it back into range and resume normal cycling. The cycle won't be permanently stalled, but the bacterial growth will be slower until levels are back in range. The calculator handles this case with the Fishless Cycle scenario toggle.
Why is nitrite as dangerous as ammonia? My test kit makes ammonia look scarier.
Nitrite is actually more dangerous in the short term. It binds hemoglobin in the same way carbon monoxide does, causing brown-blood disease — fish lose the ability to carry oxygen. The visible symptom is gasping at the surface (looks like ammonia poisoning, but in this case lowering ammonia won't help). The fix is the same — water change to dilute, then let the second-stage bacteria (Nitrobacter / Nitrospira) catch up. Plain aquarium salt at the conservative beginner-safe dose of 1 tsp per 5 gallons can reduce nitrite toxicity short-term in a freshwater tank by competing with nitrite at the gill chloride channels (the chloride:nitrite protection mechanism documented in aquaculture literature). Skip the salt or halve the dose if your tank has salt-sensitive species (corydoras and other scaleless catfish, kuhli loaches, mollies' tankmates that are sensitive even though mollies aren't, freshwater shrimp/snails) or live plants that won't tolerate added chloride. Salt is a stopgap, not a substitute for the water change.
What does it mean if my tap water itself shows ammonia?
Some municipal utilities use chloramine (chlorine + ammonia bond) and the dechlorination process releases the bound ammonia. If you test your tap water 30 minutes after dosing Prime, you may see 0.5-1 ppm ammonia — that's the Prime-bound ammonia your test kit detects. It's safe (Prime keeps it bound for 24-48h), but it means your achievable post-water-change target is bounded by what's in the tap. If your tap shows persistent ammonia even without chloramine + dechlorinator, contact your water utility — that's not normal and isn't safe to drink either.
Related
- Water change calculator →
- Dechlorinator dosage calculator →
- How to cycle a new aquarium →
- Cloudy water — causes and fixes →
Math sourced from established hobby practice + EPA/USGS ammonia- toxicity literature. For sick fish or tank emergencies, talk to an aquatic veterinarian or a qualified local aquarium professional — this is calculator math, not veterinary advice. See methodology for the full sourcing tier list.