New fish or shrimp arrive in bag water that never matches your tank — different salinity, pH, temperature and TDS. This planner turns those four differences into one plan: how much tank water to add, how long the drip takes, and the float & bag alternative, plus a quarantine plan for freshwater or marine. The plan is difference-based: adding k × the bag volume of tank water dilutes every difference by 1/(1+k), so k is set by your biggest gap (minimum 2 for fish, 4 for invertebrates). Everything runs in your browser; nothing is saved.
How it works
The k-model. Adding k bag-volumes of tank water dilutes any difference by 1/(1+k), so the leftover gap is the original difference ÷ (1+k). Requiring the leftover to be within tolerance gives k ≥ difference ÷ tolerance − 1 for each parameter, and k is the biggest of those — never below the minimum (2 for fish, 4 for invertebrates). Tank water to add = k × bag volume; final volume = (1+k) × bag volume; drip time = tank water ÷ drip flow.
Drip flow. Drip flow (mL/min) = drops/sec × 0.05 × 60. A drop is only about 0.05 mL (20 drops/mL) — an approximate rule of thumb, so the times are estimates. Judge by the water level doubling, not by the clock.
Tolerances. The gaps the plan dilutes down to — fish: SG 0.001, pH 0.2, 2 °F; inverts: SG 0.0005, pH 0.2, 1 °F; TDS 20 ppm for both. The SG and pH figures come from Jay Hemdal's acclimation guide and Reef2Reef's acclimation article; TDS 20 ppm is hobby consensus only (ShrimpKeepers, Garden City Guppies), not a university figure. UF/IFAS publishes no per-parameter tolerances, so none is attributed to it. One figure was left out on purpose: a competitor uses pH 0.1 for inverts, but no source we checked supports it, so this tool uses 0.2 for inverts too. pH is logarithmic, so its k is an approximation; the others dilute linearly.
Float & bag. The alternative to dripping: float the sealed bag for 15 minutes, then add tank water in steps of 25% of the current volume, 5 minutes apart, until k × bag volume has been added. Steps = ceil(ln(1+k) ÷ ln 1.25); minutes = 15 + 5 × steps. The 15-minute float sits in the middle of the published range (Hemdal 10–15 min, Reef2Reef 20–30 min); the 25% step and 5-minute interval are Hemdal's. Note that Hemdal's own schedule is a different shape — 25%, then 50%, then 100% of the original volume — while this tool extends his step size geometrically until k is reached.
Long shipping. After 2+ hours in the bag, ammonia has built up and the bag pH has dropped — that low pH is what keeps the ammonia in its less-toxic form (UF/IFAS FA-119). Adding tank water raises the pH and turns that ammonia toxic. Tell the planner how long the animal was bagged and it warns you: float 15 minutes and net the animal straight out, or drip into a container dosed with an ammonia binder per its label.
Quarantine. The plan also sizes a quarantine tank — 10–20 gal, bare-bottom, heater and sponge filter — with 2–4 weeks of observation for freshwater and 6–8 weeks for marine. Seed the sponge filter in the main tank first, so it carries beneficial bacteria before the new fish arrive.
Worked example
A 500 mL bag with a fish, at 4 drops/sec. Bag vs tank: salinity differs by 0.003, pH by 0.4, temperature by 1.1 °C (about 2 °F).
Bag 500 mL, fish, 4 drops/sec. ΔSG 0.003, ΔpH 0.4, ΔT about 2 °F. Shipping under 2 hours, freshwater.
k = max(k_min, Δ ÷ tolerance − 1 per parameter). Tank water = k × bag. Flow = drops/sec × 0.05 × 60. Time = tank water ÷ flow.
k_SG = 0.003 ÷ 0.001 − 1 = 2. k_pH = 0.4 ÷ 0.2 − 1 = 1. k_T = 2 ÷ 2 − 1 = 0. k = max(2, 2, 1, 0) = 2. Tank water = 2 × 500 = 1,000 mL; final 1,500 mL. Flow = 4 × 0.05 × 60 = 12 mL/min; time = 1,000 ÷ 12 = 83 min. Float & bag: 5 steps, 40 min.
Add 1,000 mL over 1 h 23 min. After the plan the salinity gap is 0.003 ÷ 3 = 0.001, inside tolerance; pH is left at about 0.13 and temperature at about 0.7 °F.
The same gaps hit invertebrates much harder. A 250 mL bag of inverts with ΔSG 0.002, ΔpH 0.3, ΔT 3 °F and ΔTDS 60 ppm at 2 drops/sec: k_SG = 3, k_pH = 0.5, k_T = 2, k_TDS = 2, but the inverts minimum is 4, so k = 4 — add 1,000 mL, final 1,250 mL, 167 min at 6 mL/min, or float & bag in 8 steps and 55 min. And a 500 mL bag of inverts with only a 0.003 salinity gap: k_SG = 0.003 ÷ 0.0005 − 1 = 5, so k = 5 — add 2,500 mL over 208 min, ending at 3,000 mL, and pour off half partway through.
How to read your results
The headline is the plan: how much tank water to add, and over how long. The stat grid repeats the three numbers that matter — tank water to add, drip time, and k (how many bag-volumes) — with the final volume, the flow rate and the minimum k underneath.
Under "Notes", the first row explains why k is what it is: each difference's own k, and which one set the plan. If no differences were entered, k is just the minimum — the plan cannot grow to fit a gap you did not measure, so measure the bag water against the tank (SG, pH, temperature, TDS) before you trust it.
"Caution" means the drip rate is outside the range for that animal type — adjust the valve, or pick the animal type that matches. "Needs action" means either the long-shipping ammonia warning (do not drip slowly for hours) or the symptom reminder for quarantine. Neither is a diagnosis, and no treatment is named.
What to do next: pick drip or float & bag, watch the water level rather than the clock, and net the animal out when you move it — never pour acclimation or shipping water into the tank. Leave the lights off for the first day and wait 12–24 hours before the first light feeding.
Common mistakes
- Guessing the bag volume. Pour the bag water into a jug or container with marks — a guessed volume skews the whole plan.
- Trusting a 30–60 minute figure. For a typical container the maths gives 83–167 minutes or more; judge by the water level doubling, not by the clock.
- Dripping slowly for hours after long shipping. After 2+ hours in the bag, adding tank water raises the pH and turns accumulated ammonia toxic — float and net out, or use an ammonia binder.
- Pouring bag water into the tank. Net the animal out and discard the water — it can carry ammonia, medication and pathogens.
- Putting an airstone in the shipping bag. It raises the pH too fast and exposes the animal to lethal ammonia.
- Floating the sealed bag for far longer than 15 minutes. Hemdal calls floating longer than 15 minutes an error; the water inside warms and the oxygen runs down.
- Measuring nothing and trusting the minimum k. The minimum (2 for fish, 4 for inverts) is a safety floor, not a guarantee — without measurements a big gap stays hidden.
- Treating the pH k as exact. pH is logarithmic, so its k is an approximation; the others dilute linearly.
Tolerances — the gaps the plan dilutes down to
Fish and invertebrate tolerances side by side, with where each figure comes from.
| Difference | Fish | Invertebrates | Source |
|---|---|---|---|
| Salinity (ΔSG) | 0.001 | 0.0005 | Fish: Reef2Reef "How to Acclimate"; inverts: Hemdal |
| pH | 0.2 | 0.2 | Hemdal, for all animals (a competitor's 0.1 for inverts is unverified and not used) |
| Temperature | 2 °F | 1 °F | Hemdal (float band 1–2 °F; release target 1 °F) |
| TDS | 20 ppm | 20 ppm | Hobby consensus only — ShrimpKeepers, Garden City Guppies |
| Minimum k | 2 | 4 | Safety floor, not a measured tolerance |
UF/IFAS FA-119 publishes no per-parameter tolerances — the tolerance set above is attributed to Hemdal, Reef2Reef and hobby consensus, never to UF/IFAS. TDS is also composition-blind: a TDS meter cannot tell minerals from nitrate.
Drip time by rate — adding 1,000 mL (the worked example)
| Drops/sec | Flow (mL/min) | Time to add 1,000 mL |
|---|---|---|
| 1 | 3 | 333 min (5 h 33 min) |
| 2 | 6 | 167 min (2 h 47 min) |
| 3 | 9 | 111 min (1 h 51 min) |
| 4 | 12 | 83 min (1 h 23 min) |
| 6 | 18 | 56 min |
Flow = drops/sec × 0.05 × 60; time = 1,000 ÷ flow. A drop is only about 0.05 mL, so these are estimates — judge by the water level, not the clock. At 4 drops/sec the drip runs at 240 drops/min.
FAQ
Do I need to measure all four differences?
No. Enter what you can test and leave the rest blank — a blank difference counts as no gap. The minimum k (2 for fish, 4 for inverts) still applies, but without measurements the plan cannot grow to fit a gap you did not find.
Why is k at least 2 for fish and 4 for invertebrates?
It is a safety floor, not a measured tolerance: even a small gap gets a real dilution, and invertebrates — shrimp, snails, starfish, corals — are far more sensitive to salinity and pH changes than fish, so they get the larger floor.
Why does the float & bag method finish sooner than the drip?
You pour in 25% of the container at a time instead of dripping, so the same k is reached in about 40 minutes instead of 83 in the worked example. The trade-off is bigger steps; the drip is gentler, so use it for the most sensitive animals.
The fish was shipped overnight — should I still drip for hours?
No. After a long trip ammonia has built up in the bag and the low pH is what keeps it less toxic; adding tank water raises the pH and turns it toxic. Float the sealed bag for 15 minutes and net the animal straight out, or drip into a container dosed with an ammonia binder per its label. Tell the calculator how long the animal was bagged and it warns you.
Where do the tolerance numbers come from?
Fish SG 0.001 and the float-and-release rules come from Reef2Reef's acclimation article; pH 0.2, SG 0.0005 and 1 °F come from Jay Hemdal's acclimation guide; TDS 20 ppm is hobby consensus (ShrimpKeepers, Garden City Guppies), not a university figure. UF/IFAS publishes no per-parameter tolerances, so none is attributed to it — and a competitor's pH 0.1 figure for inverts is not used here because no source we checked supports it.
Why is the drip time so much longer than the 30–60 minutes the guides mention?
Because the guides' figures do not match the maths for a typical container. At 2 drops/sec the flow is only 6 mL/min, so adding 1,000 mL takes 167 minutes — and at 1 drop/sec it takes 333 minutes. The 30–60 minute figures assume a much smaller container or a much faster drip than the animal ranges allow.
Can I use this planner for corals and shrimp?
Yes — pick "Inverts". They get the stricter tolerances (SG 0.0005, 1 °F) and the larger minimum k of 4, because a salinity gap matters far more to a shrimp or coral than to a fish.
Sources
- Hemdal, Jay F. — "Acclimating Animals to Aquariums", Reef2Reef (Expert guide). reef2reef.com/ams/acclimation-methods.903/
- Reef2Reef — "How to Acclimate" (Hobby guide). reef2reef.com/threads/how-to-acclimate.192300/
- UF/IFAS Extension — FA-119, On-Farm Transport of Ornamental Fish (Government). edis.ifas.ufl.edu/publication/FA119/pdf — ammonia mechanism and the >10 °C / 2+ hour rule only; publishes no per-parameter tolerances.
- Innovative Marine — acclimation guide (Manufacturer). Innovative Marine acclimation guide (PDF) — drip-rate ranges 1–4 drops/sec.
- Worldwide Corals — New Fish Acclimation Guidelines (Manufacturer). worldwidecorals.com/pages/new-fish-acclimation-guidelines — 4–6 drops/sec; 6–8 week marine quarantine.
- The iFish Store — Buying Fish Online: Shipping, Acclimation & Safe Quarantine (Retailer guide). theifishstore.com — 2–4 week freshwater quarantine.
- ShrimpKeepers — Shrimp Dying After Water Change (Hobby practice). shrimpkeepers.com — TDS within 20 ppm.
- Garden City Guppies — Neocaridina Shrimp Care Guide (Hobby practice). gardencityguppies.com — keep TDS changes under 20 ppm.
- LiveAquaria — Step-by-Step Acclimation Guide (Retailer guide). liveaquaria.com — small-step additions; never put an airstone in the shipping bag.