How aquarium stocking really works
Deciding how many fish a tank can hold is one of the first real questions a freshwater aquarist faces, and it is the one most often answered badly. The old "one inch of fish per gallon" rule is easy to remember and almost always wrong. This calculator takes a different approach based on bioload, the amount of waste a fish actually produces, and pairs it with compatibility checks that a length-based rule cannot make. This page explains how stocking really works, why the inch-per-gallon myth persists, and how to read the numbers the tool gives you.
What "stocking" actually measures
A healthy aquarium is a small, closed nitrogen cycle. Fish eat, and they excrete ammonia. Ammonia is highly toxic, so in a cycled tank a colony of beneficial bacteria converts it first into nitrite (also toxic) and then into nitrate (far less toxic), which you export by changing water. "How many fish can I keep" is really the question "how much ammonia can my system process and dilute before it stresses the animals." That capacity depends on three things: how much water you have to dilute waste, how much biological filtration you run to convert it, and how much waste the fish themselves produce. Stocking level is simply the ratio between the waste your intended fish create and the waste your system can comfortably handle.
Why the inch-per-gallon rule fails
The inch-per-gallon rule assumes every centimetre of fish produces the same waste. It does not. Waste output scales much more closely with body mass and metabolism than with length, and mass grows roughly with the cube of length. A fish twice as long is not twice the load; it can be closer to eight times the load. That is why a single 10 cm goldfish or common pleco overwhelms a small tank that could comfortably house 10 cm worth of neon tetras several times over. The rule also ignores body shape (a chunky cichlid versus a slim danio), activity level, and, crucially, whether the fish can even coexist. A rule that would happily pair a betta with a school of fin-nipping tiger barbs is not a stocking guide; it is a coincidence generator.
How this calculator models bioload
Every species in the dataset carries a bioloadFactor, a relative waste weight where a common platy is set to 1.0. A neon tetra is roughly half a platy at 0.5; a messy adult oscar is many times a platy. These figures are deliberately conservative estimates drawn from general aquarium-keeping knowledge and rounded upward, so the tool errs toward recommending a lighter stock rather than a crowded one. When you add fish, the calculator sums their bioload and compares it against a capacity figure.
Capacity starts from your tank's usable water volume. A tank almost never holds its labelled size once you subtract the rim, substrate, rocks, wood, and equipment, so the tool discounts your entered volume to about 90 percent. It then allows one bioload unit for roughly every five litres of usable water at a baseline of standard filtration and no live plants. Two multipliers adjust that baseline. Stronger filtration raises capacity because more biological media and turnover process more waste; gentle filtration lowers it. Live plants raise it modestly because growing plants take up ammonia and nitrate directly as fertiliser. The final stocking percentage is your total bioload divided by this capacity.
Reading the verdict
The tool sorts the result into three plain bands. Below about 85 percent the tank is comfortable: there is headroom for the occasional missed water change and for fish that are still growing. Between 85 and 100 percent the tank is fully stocked, which is a fine place to be if, and only if, you keep up a steady water-change routine and resist the urge to add "just one more" fish. Above 100 percent the tank is overstocked, and the fix is to remove animals or move up to a larger tank rather than to filter your way out of the problem. Filtration converts ammonia; it does not make a cramped tank spacious or reduce the aggression that crowding causes.
Numbers are only half the job: compatibility
Being under capacity tells you the waste load is manageable. It says nothing about whether the fish will get along, and that is where most stocking plans quietly fail. The calculator runs several independent checks and raises a warning for each problem it finds, separate from the percentage.
The first is group size. Many popular fish, including most tetras, rasboras, danios, and corydoras, are shoaling species that are stressed and skittish in small numbers. Keeping six or more lets them behave naturally, so the tool warns when you add fewer than a species needs. The second is minimum tank size. A fish can be a light bioload and still be wrong for a tank because it needs swimming room or grows large; a common pleco is the classic example, eventually reaching 45 cm and needing a tank most hobbyists never own.
The third set of checks is behavioural. An aggressive fish kept with peaceful tankmates will harass them, so that pairing is flagged. A known fin-nipper housed with long-finned fish such as guppies, bettas, or angelfish will damage those fins over time. A predator will eat any tankmate small enough to fit in its mouth, no matter how peaceful it otherwise seems. Finally, the tool checks water chemistry: it looks at whether every species you have chosen shares a common temperature range and a common pH range, and warns you if their comfortable bands do not overlap. A cool-water white cloud mountain minnow and a warm-water German blue ram simply cannot both be comfortable in the same water.
Cycling comes first, always
The single most important thing this calculator assumes is that your tank is already cycled. Cycling is the process of growing the beneficial bacteria that convert ammonia to nitrite and nitrite to nitrate before fish depend on them. In a brand-new tank those bacteria do not yet exist, so any ammonia the fish produce accumulates to toxic levels. This is why so many first tanks lose their fish in the first few weeks, an outcome sometimes called new-tank syndrome.
A fishless cycle is the kindest method. You add a source of ammonia to an empty, filtered tank and test the water every day or two. Ammonia will rise and then fall as the first bacteria establish; nitrite will rise and then fall as the second group catches up; nitrate will appear at the end. When the tank can take a dose of ammonia to a few parts per million and reduce both ammonia and nitrite to zero within 24 hours, it is cycled and ready. This usually takes several weeks. Seeding the filter with media from an established, healthy tank can shorten it considerably. Once cycled, add fish gradually rather than all at once, so the bacterial colony can grow to match the rising load.
Worked examples
A 75 litre planted community. Suppose you enter 75 litres, standard filtration, and light planting, then add eight neon tetras, six harlequin rasboras, and six bronze corydoras. Usable volume is about 67.5 litres, giving a capacity near 14 bioload units after the planting bonus. The fish total about 11.8 units, so the tank lands around 83 percent: comfortable, with a little headroom, and no compatibility warnings because all three species are peaceful, kept in proper groups, and share overlapping temperature and pH ranges. This is a well-judged community.
One big fish in a small tank. Enter 40 litres and add a single common pleco. The bioload alone pushes the tank well past 150 percent, and on top of that the tool flags that a common pleco needs at least 550 litres. The lesson is that a single fish can be badly overstocked, and that a low fish count is not the same as a light load.
A lonely schooler. Add just one neon tetra to a 60 litre tank and the percentage is trivially low, but the tool still warns you: a neon tetra is a shoaling fish and should be kept in a group of at least six. The number looks fine; the welfare of the fish does not. Reading the warnings is as important as reading the percentage.
Keeping a stocked tank healthy
Once your stock is in place, the routine that keeps it healthy is unglamorous and effective: regular partial water changes, sensible feeding, and not overstocking in the first place. Water changes export the nitrate that filtration cannot remove and replenish minerals the fish and plants consume. A reasonable starting schedule is 15 percent of the volume each week for a lightly stocked tank, 25 percent for a moderate one, and 40 percent for a heavily stocked one, always with temperature-matched, dechlorinated water. Feed only what the fish finish in a couple of minutes, since uneaten food is pure bioload with no benefit. If you ever see fish gasping at the surface, clamped fins, or a sudden loss of appetite, test the water before doing anything else; those are the signs that the balance this calculator helps you plan has slipped, and a water change is almost always the first response.
Used together with the companion tank volume, heater wattage, and water-change calculators, this tool turns stocking from guesswork into a short, checkable plan. Enter your real volume, build your community a few fish at a time, read both the number and the warnings, and you will avoid the crowding and incompatibility problems that the inch-per-gallon rule invites.