Pick your tank size and the species you want, and get a verdict from the site's own care-guide numbers — minimum tank size, school sizes, shared temperature and pH, temperament and waste level. No inch-per-gallon math: that rule is wrong, and the stocking guide explains why. Everything runs in your browser; nothing is saved.
How it works
The checker runs five checks on your stocking and gives one of three verdicts. The numbers come from our own care guides — the same ranges in the table below — not from a generic rule.
Minimum tank size. Every species has a minimum tank size from its care guide. Your tank must meet the largest minimum in the stocking — a 10-gallon tank passes for ember tetras (10 gal minimum) but fails for a panda cory group (15 gal minimum).
School size. Schooling fish need their minimum group. Ember tetras, harlequin rasboras, panda corys, black ruby barbs and celestial pearl danios need at least 6; chili rasboras need at least 8. A school below its minimum stresses the fish, and the checker says exactly how many to add.
Shared temperature and pH. For each, the shared range is [the highest minimum, the lowest maximum] across all the species you picked. If the ranges do not meet at all, that is a block. If the shared range is narrower than 2°F (temperature) or 0.5 (pH), it is flagged as hard to hold stable.
Temperament. A solitary species blocks any mixed stocking — in our data that is only the betta. A betta with tankmates usually ends in chasing, nipped fins, or worse, and most bettas also hunt dwarf shrimp.
Waste level. Waste is flagged as notes, not a computed number: goldfish are waste factories and need oversized filtration and water changes above the routine 25–30%, while a cherry shrimp colony's bioload barely registers — for shrimp, stable water matters more than space.
Why not inch-per-gallon? That rule measures length while waste scales with mass: weight grows with the cube of length (Froese, 2006), so a fancy goldfish about 5× longer than a neon tetra weighs roughly 250× as much. One inch of goldfish and one inch of neon tetra are not the same load, and no length rule accounts for filtration, planting, or territory. This checker tests the things that actually decide stocking instead.
The verdicts. "Looks compatible" means no blocks and no cautions. "Risky — fix the warnings" means nothing here is an instant disaster, but the flagged items stress fish over time. "Won't work as listed" means at least one blocking problem — fix those first, then re-check.
Scope. This checker covers the ten freshwater species in our care guides. It does not test predation, individual temperament, or footprint — a long tank suits schooling fish better than a tall one of the same gallons, and plants raise the waste budget but never fix a missing school or a too-small footprint.
Worked example
20-gallon tank: 8 Ember Tetras + 6 Harlequin Rasboras.
Tank: 20 gal. Ember Tetra: min 10 gal, school 6+, 72–78°F, pH 6.0–7.0. Harlequin Rasbora: min 10 gal, school 6+, 73–77°F, pH 6.0–7.0.
Tank must meet the largest minimum. Shared range = [max of minimums, min of maximums], for temperature and pH. Schools must meet their minimums.
Largest minimum = max(10, 10) = 10 gal; your 20 gal passes. Shared temp = [max(72, 73), min(78, 77)] = 73–77°F, 4°F wide. Shared pH = 6–7, 1.0 wide. Schools: 8 ≥ 6 and 6 ≥ 6. Both peaceful.
"Looks compatible" — keep at 73–77°F, pH 6–7, with at least 6 of each, in a tank of 10 gal or more (yours is 20 gal).
The opposite case shows what a block looks like. A betta + 6 ember tetras in the same 20-gallon tank: the water matches (shared 76–78°F, pH 6.5–7), but the verdict is "Won't work as listed" — the betta is solitary. No water match overcomes that. And 4 ember tetras alone in 20 gallons is "Risky": the tank and water pass, but the school is 2 short of its minimum of 6.
How to read your results
The verdict word is the headline. Under it, the stocking line names every species and count, and the stat grid shows the three numbers that decide the tank: shared temperature, shared pH, and your tank size against the largest minimum.
Aim for the middle of a shared range, not the edge. A tank held at the edge leaves no room for a heater overshoot or a cold night; the middle absorbs small swings.
Below the stats, the checks are grouped. "Needs action" is a block — fix it before buying. "Caution" is a risk — possible with more of the schooling species, more space, or a different mix. "OK" means that check passed. If there are fixes, they are listed under "How to fix it", each naming the exact change.
What to do next depends on the verdict. "Looks compatible": still read the care guides — predation and individual temperament are not tested. "Risky": work through the caution rows before you buy. "Won't work as listed": change one species, raise the school, or get a bigger tank.
Common mistakes
- Stocking by inch-per-gallon. Length is not load — waste scales with mass, so a goldfish counts far more than a tetra of the same length.
- Judging by one number — "both like 76°F" — without checking whether the full ranges overlap.
- Forgetting school size. Four ember tetras in a big tank are still a stressed school.
- Keeping a betta with tankmates because it "seemed fine for a week". Chasing and fin-nipping often start later.
- Using the label volume instead of the real water volume. Substrate, rock and the rim gap take 10–20% of a tank's labelled size — measure the real water if the stocking is close to the limit.
- Adding all the fish at once. Add a few at a time, a week or two apart, so the filter bacteria keep up.
- Ignoring footprint. A tall 20-gallon tank and a long 20-gallon tank hold the same water, but schooling fish need the long one.
- Treating "Looks compatible" as a guarantee. It does not test predation or individual temperament.
Species stocking numbers
The numbers this checker runs on — our recommendations from our care guides, in alphabetical order.
| Species | Temperature | pH | GH | Min tank | School | Temperament | Adult size |
|---|---|---|---|---|---|---|---|
| Betta | 76–82°F | 6.5–7.5 | — | 5 gal | — | Solitary | 2–3 in |
| Black Ruby Barb | 72–76°F | 6.0–7.0 | 5–12 | 20 gal | 6+ | Peaceful | 2–2.5 in |
| Bolivian Ram | 74–78°F | 6.0–7.5 | 5–15 | 20 gal | — | Peaceful | 3 in |
| Celestial Pearl Danio | 72–76°F | 6.5–7.5 | 2–12 | 10 gal | 6+ | Peaceful | 0.75–1 in |
| Cherry Shrimp | 65–78°F | 6.5–7.5 | 6–8 | 5 gal | — | Peaceful | — |
| Chili Rasbora | 74–78°F | 5.0–7.0 | 1–8 | 5 gal | 8+ | Peaceful | 0.6–0.8 in |
| Ember Tetra | 72–78°F | 6.0–7.0 | 1–10 | 10 gal | 6+ | Peaceful | 0.8 in |
| Goldfish (Fancy) | 65–75°F | 7.0–8.4 | — | 20 gal | — | Peaceful | 6–8 in |
| Harlequin Rasbora | 73–77°F | 6.0–7.0 | 5–12 | 10 gal | 6+ | Peaceful | 1.5–2 in |
| Panda Cory | 68–74°F | 6.0–7.0 | 2–12 | 15 gal | 6+ | Peaceful | 2 in |
— means the value was not verified for that species and is left blank, never guessed. These are our recommendations — the ranges we publish in our care guides — not the full documented range. Cherry shrimp, for example, can survive to about 82°F, but breeding falls off above 78°F, so 65–78°F is the range we recommend for a colony that thrives. See Sources.
FAQ
Why doesn't this calculator give a stocking percentage?
Because a single percentage hides the real problems. A stocking can be "87% stocked" and still have a school of three, a betta with tankmates, or two species whose temperature ranges never meet. This checker reports each check separately, so you see the actual problem instead of a blended number.
Can I keep a betta with other fish?
The checker says no. Males are solitary and territorial — Seriously Fish puts it plainly: best kept alone, and not recommended for the standard community aquarium. Some experienced keepers keep one male with calm, non-nippy tankmates in a large planted tank, but that is an exception, and shrimp are still at risk because bettas prey on invertebrates.
My tank passes but the verdict is "Risky" — why?
Cautions do not block, but they stress fish over time: a school below its minimum, or a very narrow shared temperature or pH range. Read the caution rows — each one says what to do about it.
Does "Looks compatible" mean it is guaranteed?
No. The checker does not test predation or individual temperament. Read the care guides, watch new arrivals for the first weeks, and have a plan — a spare tank or a return — if one fish does not fit.
What if my species isn't listed?
The checker covers the ten species in our care guides. If yours is not there, compare its minimum tank size, school size, temperature, pH and temperament against the table above using the same rules — largest minimum, shared range, and school minimums.
Do plants or strong filtration let me stock more?
They raise the waste budget a little — heavy planting and strong filtration help — but they never fix a missing school, a solitary betta with tankmates, or a tank too small for the species. Fix the checks first; filtration is not a substitute.
Should I use the label size or the real water volume for the tank size?
The real water volume. Substrate, rock and the rim gap take 10–20% of a tank's labelled size. If your stocking is close to a limit, measure the water you actually have — or use the Actual Water Volume Calculator.
Sources
- Froese & Pauly (eds.), FishBase — adult lengths (Standard). fishbase.org
- Froese, R. (2006), Journal of Applied Ichthyology 22: 241–253 — weight–length relationships; weight scales with length cubed (Peer-reviewed).
- Seriously Fish — Betta splendens species profile (Species profile). seriouslyfish.com/species/betta-splendens/
- TheCycledTank species database — the care-guide numbers this checker runs on (Our recommendation).
- TheCycledTank care guides — Betta (betta-fish-care-guide) and Cherry Shrimp (cherry-shrimp-care-guide) (Our care guides).
- TheCycledTank stocking guide — why inch-per-gallon is wrong (aquarium-stocking-guide) (Our guide).