The aquarium stocking calculator answers the question every fishkeeper asks before a shopping trip: how many fish can I actually put in this tank? You enter your tank size and your filter, add the species you are considering, and the tool weighs the things that decide the answer, adult size, waste output, filtration, and social needs, to give you a stocking level and a warning when you are crowding the water. It exists because the two most common beginner mistakes, overstocking and buying fish that outgrow the tank, are also the two easiest to avoid with a few minutes of planning.
Let me be clear about what this is and is not. It is a planning aid that gives you responsible guidance, a way to sanity-check an idea before it becomes a tank full of stressed fish. It is not a substitute for cycling your aquarium, researching each species, and watching your own water parameters. No calculator replaces those habits. What it can do is steer you away from the obvious traps and toward a plan that gives your fish room to thrive.
What this tool does and who it is for
Instead of guessing, or trusting a store employee who wants to make a sale, you get an estimate grounded in the real limits of your system. You tell it the tank dimensions or the volume and the fish you want, and it returns a stocking percentage along with notes about which choices are pushing things too far.
It is built for beginners setting up a first freshwater community tank, for hobbyists planning an upgrade or a rescape, and for anyone who has watched their water go cloudy and their fish go listless and wondered whether they simply had too many. It is equally useful as a reality check before you go shopping, so you walk into the store with a plan rather than falling for whatever looks pretty under the shop lights.
The tool leans conservative on purpose. A slightly understocked tank is a forgiving, stable one, with a buffer against mistakes and room for fish to reach full size. An overstocked tank is a constant struggle. If the aquarium stocking calculator nudges you toward fewer fish than you hoped, that is the tool doing its job.
Why the old one inch per gallon rule falls short
For decades beginners were handed a single guideline: one inch of fish per gallon of water. It is easy to remember and it is better than nothing, but it breaks down the moment you look closely, and leaning on it is how a great many tanks end up overstocked.
The first problem is body mass. A slim neon tetra and a chunky fish can both measure an inch, yet the chunkier fish has far more body, eats far more, and produces far more waste. Waste scales roughly with mass, not with length, so counting inches ignores most of what matters. The rule gets absurd at the top end: it implies a single ten-inch fish is equivalent to ten one-inch fish, when the big fish's bioload, oxygen demand, and space needs dwarf the little school by a wide margin.
The rule also ignores adult size. Fish are sold small and grow, so one inch per gallon measured at the store bears no relation to the tank you will have in a year. It ignores surface area, treating a tall narrow tank the same as a wide shallow one even though they exchange oxygen very differently. And it ignores behaviour entirely, saying nothing about schooling fish that need groups, territorial fish that need space, or aggressive fish that cannot share at all. Use the inch-per-gallon idea, if at all, as a loose gut check for small community fish, and let a proper aquarium stocking calculator handle the rest.
The factors that really decide stocking
Good stocking is a balance of several forces. Here is what the calculator weighs, and why each one earns its place.
Bioload
Bioload is the amount of biological waste your fish place on the system, mostly the ammonia produced by their waste and their breathing. Every fish adds to it, but not equally. Messy, heavy-bodied fish like goldfish, cichlids, and plecos produce a large bioload, while small tetras and rasboras produce very little. A tank's real limit is how much bioload its filter and bacteria can process while keeping the water safe, so the calculator thinks in terms of waste rather than headcount. This is why a tank can look half empty and still be fully stocked if it holds one big messy fish.
Filtration and turnover
Your filter is the workhorse. The beneficial bacteria living inside it convert toxic ammonia into nitrite and then into nitrate, and the more filtration you run, the more bioload the system can safely support. A widely used target is a filter rated to move roughly four times your tank's volume every hour, so a 20 gallon tank wants something in the neighbourhood of 80 gallons per hour. Extra filtration buys headroom, but it has limits. It will not make a small tank big enough for a fish that needs room to swim, and it never removes the need for regular water changes to export the nitrate that filters leave behind.
Surface area and oxygen
Fish breathe dissolved oxygen, and gas exchange happens mainly at the water's surface, where oxygen enters and carbon dioxide escapes. A wide, shallow tank has more surface than a tall, narrow one of the same volume, so it can support more fish comfortably. Surface movement from a filter outflow or an air stone increases that exchange further. This is why tank shape, not just gallons, shapes how many fish belong in the water, and why a tall show tank may hold fewer fish than its volume suggests. Enter your dimensions rather than a volume and the tool can see this.
Adult size, not purchase size
This one catches almost every beginner. The fish in the store are usually juveniles. Common plecos reach a foot or more, common goldfish pass eight inches, and various sharks and larger barbs grow well beyond their tank-store cuteness. Stock for the adult, always. A group that fits comfortably at purchase can become a cramped, polluted mess within months if you ignored how big those fish get. Every size in the built-in list is a typical adult size, so your plan holds up over the fish's life rather than just the first week.
Schooling, territory, and the water column
Behaviour is as real a constraint as chemistry. Schooling and shoaling fish such as tetras, rasboras, danios, and corydoras need company to feel secure, usually six at a minimum and often better in larger groups. Kept alone or in pairs they grow stressed, hide, lose colour, and can turn nippy. That means you must budget for the whole school, not one fish, and the tool warns you the moment a group drops below its minimum. At the other extreme, territorial and aggressive fish like bettas, many cichlids, and some gouramis need space and carefully chosen tank mates regardless of their size. Finally, fish occupy different levels: bottom dwellers like corydoras, mid-water schoolers, and surface fish. The stats panel counts your top, middle, and bottom fish so you can see whether you are using the whole tank or crowding one layer.
The nitrogen cycle: stock only after you cycle
No stocking plan is safe until your tank is cycled, so this deserves its own section. Cycling establishes the nitrogen cycle. When fish produce waste it releases ammonia, which is highly toxic. In an established tank one group of beneficial bacteria converts ammonia into nitrite, still toxic, and a second group converts nitrite into nitrate, which is far less harmful and removed through water changes. Until those colonies exist in enough numbers, ammonia and nitrite build up and poison the fish, a problem so common it has a name: new tank syndrome.
The safest approach is a fishless cycle, where you add an ammonia source and wait, usually several weeks, until the tank can convert a dose of ammonia all the way to nitrate within a day. Only then do you add fish, and even then you add them a few at a time so the bacteria can multiply to match the rising bioload. Dumping a full stock into a fresh tank overwhelms the young colony and kills fish. The aquarium stocking calculator assumes an established, cycled tank running steadily, so treat cycling as the step that comes before any stocking plan, not after.
How the ToolFiddle aquarium stocking calculator works
Most stocking tools give you one number. This one gives you two, because a tank fills up in two different ways and the honest answer is whichever runs out first.
The first is bioload. Waste rises steeply with body size, far faster than length alone suggests, so each species carries a demand based on its adult size raised to a power and multiplied by how messy it is. That total is compared against what your water volume and your filtration can process. Run a bigger filter and this number falls, because more filtration genuinely does buy you headroom on waste.
The second is swimming space. Territory and swimming room scale far more gently with size, and even a tiny fish needs somewhere to be. Each species carries a second demand based on its adult size and its temperament, compared against the footprint your tank actually offers. No filter in the world buys this back, which is why the tool keeps it separate.
The headline percentage is the larger of the two, and the panel tells you which one is driving it. That single design choice explains a lot of fishkeeping at a glance. One common pleco maxes out a 20 gallon on waste alone while the tank still looks empty. Fourteen nano fish max out a 10 gallon on space alone while the filter barely notices them. Both tanks are full, for completely different reasons, and a single inch-per-gallon number can never say so.
Before either calculation runs, the tool works out your real water volume, since a tank never holds its labelled gallons once substrate, rocks, decorations, and equipment take up space and you leave a gap at the top. If you enter dimensions it also reads the depth, because a tall tank trades surface area for volume and exchanges gas less freely than a wide one.
All of this runs in your browser the instant you make a change, so you can experiment. Swap a pleco for a small school of corydoras and watch the level drop. Add a bigger filter and see the bioload meter fall while the swimming-space meter stays put. Try a 20 gallon against a 29 gallon for the same fish list and compare. Nothing is uploaded and nothing is saved to a server, so you can plan and replan as many tanks as you like, privately and for free.
The tool is honest about its limits, which is part of being responsible. It cannot measure your actual filter, your maintenance discipline, or the temperament of the individual fish you bring home. It gives you a well-reasoned estimate and clear warnings, and it expects you to pair that with species research and your own water testing.
How to use the tool step by step
- Enter your tank. Dimensions are the better input, because they give the tool the surface area and depth as well as the volume. If you only know the label, switch to volume mode and type the gallons or litres. The preset buttons fill in the standard sizes, from a 5 gallon up to a 75, with a sensible filter to match.
- Set the displacement. The substrate and decor field defaults to 12 percent, which is about right for a normal setup. Push it higher for a heavily aquascaped tank with deep sand and a lot of hardscape, lower for a bare-bottom quarantine tank.
- Enter your filter's rated flow. The number on the box is what you want. The panel shows your turnover against the usual four-times-per-hour target, and warns you if you are short.
- Add the fish you are considering. Pick a species and a number, then press Add. The count box pre-fills with the species minimum group size, so schoolers arrive as a school rather than as a lonely single. Anything not on the list goes in through the custom drawer with a name, an adult size, and a waste level.
- Read the gauge and the two meters. The big percentage is how full the tank is. The meters underneath show whether waste or swimming room is the limit, and the highlighted one is the one doing the work.
- Work through the warnings. Groups below their minimum, fish that will outgrow the tank, a filter running under target, and a water column with nothing on the bottom all get flagged with a specific fix.
- Adjust and compare. Use the plus and minus buttons on each row to nudge a group up or down, drop a heavy fish, or hit a bigger preset, and watch the level respond until you land on a plan with comfortable headroom.
- Copy it and go shopping. The copy button puts the whole plan on your clipboard as plain text, tank, filter, fish list, level, and warnings, ready to paste into a note before you head to the store.
The whole process takes a couple of minutes and can save you months of struggling with a crowded, unstable tank.
Worked example: a 10 gallon nano community
You have a cycled 10 gallon tank, 20 by 10 by 12 inches, with a small filter rated around 50 gallons per hour. That is the 10 gal preset in the panel. You want a lively little community, so you try eight ember tetras and six pygmy corydoras.
The tool reports 65 percent, comfortably stocked, and the interesting part is the split underneath. Bioload sits at just 29 percent, because ember tetras and pygmy corys are among the smallest and cleanest fish in the hobby and that filter turns the tank over five and a half times an hour. Swimming space sits at 65 percent, and that is what the headline is reading. Fourteen fish is fourteen fish, however tiny they are, and a 10 gallon footprint only holds so many bodies.
Add four cherry shrimp and the level moves to 74 percent, still comfortable, with bioload barely stirring at 33 percent. Shrimp cost almost nothing in waste, which is exactly why so many nano keepers use them to add life without adding load. The tool does flag that four cherry shrimp is below the group of six they prefer, and taking them to six brings the level to 79 percent, which is about as full as a 10 gallon should get.
The lesson here is that filtration was never the constraint. Upgrading that filter would drop the bioload meter and leave the headline untouched, because in a nano tank full of nano fish you run out of room long before you run out of biological capacity. A single betta with four nerite snails is the other classic 10 gallon plan, and it lands at 31 percent, which is why it works so well.
Worked example: a 20 gallon beginner community
Now a cycled 20 gallon long, 30 by 12 by 12 inches, with a filter rated 80 gallons per hour. Notice that the glass measures about 18.7 gallons even though the box says 20, and after 12 percent for substrate and decor you are working with roughly 16.5 gallons of real water. That gap is normal and it is the first reason to stay under any calculated ceiling.
The plan the tool loads with is eight neon tetras, five guppies, and six pygmy corydoras. That comes out at 73 percent, comfortably stocked, limited by swimming space at 73 percent with bioload trailing at 52 percent. Nineteen fish spread across the top, middle, and bottom of the tank, every school at or above its minimum, and enough headroom left that a missed water change is an inconvenience rather than a crisis.
Swap the pygmy corys for six full-size bronze corydoras and the picture changes. Bronze corys reach two and a half inches against the pygmy's one, and the level climbs to 94 percent, close to the ceiling. Same fish count, same tank, same filter, and the plan has gone from roomy to full purely because the adult size of one line item more than doubled. This is the single most useful thing the tool does: it shows you what adult size costs before you buy the juvenile.
Now try the upgrade instead. Raise the filter from 80 to 150 gallons per hour on the original plan and the bioload meter drops from 52 to 46 percent while the headline stays at 73 percent. The filter genuinely helped, and it helped with the thing that was never the problem. That is the clearest demonstration of why the tool separates the two limits, and it is a much more useful answer than a single number that quietly improves when you buy a bigger pump.
One more comparison worth running. Take the same nineteen fish and put them in a 20 gallon high instead, 24 by 12 by 16 inches. The label is the same, the glass actually holds slightly more, and yet the level rises to 77 percent, because the tall tank trades surface area for depth and a smaller footprint gives the fish less floor to spread across. Two tanks, one number on the box, different answers.
Worked example: the classic overstocking trap
Someone brings home two cute two-inch common goldfish for a 10 gallon tank, reasoning that four inches of fish fits four gallons with room to spare by the inch-per-gallon rule.
The aquarium stocking calculator returns 496 percent and flags it hard. Bioload is the culprit at 496 percent, with swimming space at 112 percent, because common goldfish reach about ten inches, eat constantly, and produce waste on a scale that small tropical fish never approach. The warning panel names the specific problem in plain words: common goldfish are generally kept in 75 gallons or more, and they are sold as juveniles, so this one will outgrow the tank rather than stay the size you bought.
Put the same two fish into a 75 gallon with a 350 gallon per hour filter and the level comes back at 84 percent, bioload driving it and swimming space at a relaxed 18 percent. Nothing about the fish changed. The tank changed. That is what a proper goldfish setup looks like, and it is a long way from the bowl the hobby spent decades selling.
The same trap catches plecos. Add one common pleco to that 20 gallon community and the level jumps to 315 percent, almost entirely on bioload, with a warning that a common pleco reaches around fifteen inches and wants 125 gallons or more. Swap it for a bristlenose pleco, which tops out near five inches, and the level lands at 93 percent instead: close to the ceiling rather than off the scale. The tool still notes that a bristlenose is usually kept in 29 gallons or more, which is a fair reservation about a 20 gallon, but the difference between the two fish is the difference between a tight tank and a disaster.
Common beginner fish worth knowing
A quick, responsible tour of hardy, widely available species that suit new tanks. All of them are on the built-in list. Always research each one before buying.
- Guppies, platies, and mollies are livebearers: hardy, colourful, and active. They breed readily, so plan for population growth or keep a single sex. Mollies get considerably larger and appreciate more room than the other two.
- Neon and ember tetras are small, peaceful schoolers that shine in groups of six or more. They want stable, established water and look their best against plants.
- Zebra danios are tough, fast, and forgiving, ideal for a first tank, but they are active swimmers that need horizontal room and a proper group.
- Corydoras catfish are gentle bottom dwellers that must be kept in groups of six or more. They tidy up leftover food and add real charm at the substrate. Pygmy corys are the nano-tank version.
- A single male betta can be a centrepiece in a small tank of a few gallons or more, with a gentle filter and warm water. Keep only one male, and choose any tank mates carefully.
- White cloud mountain minnows are a great choice for cooler rooms without a heater, hardy and peaceful in a group.
- Snails and dwarf shrimp such as cherry or amano shrimp round out many tanks with very little added bioload, though shrimp need a fully cycled, stable tank and cannot share with fish that would eat them.
The list also carries the fish people most often get wrong, including common goldfish, common plecos, tiger barbs, and angelfish, precisely so you can see what they cost before you commit.
How fishkeepers actually use this
New hobbyists use it before their first shopping trip, turning a vague wish list into a plan that fits their tank and leaves room to grow. It is far easier to say no in the aisle when you already know the tank is full.
Upgraders use it to work out how much more they can add after moving to a bigger tank, and to check whether a fish they love will finally have the space it needs. Running the old tank and the new one side by side takes about thirty seconds.
Troubleshooters use it when a tank keeps going wrong, cloudy water, algae, stressed or sick fish, to see whether overstocking is the hidden cause. Often the fix is fewer fish, more filtration, or both, and the two meters tell you which.
Anyone rehoming a fish that outgrew its tank uses it to right-size the next setup, so the same mistake does not repeat. A common pleco that hit ten inches needs a very different plan from the three-inch juvenile it once was.
And shoppers use it to compare tanks rather than fish. Two aquariums with the same number on the box can support noticeably different stockings depending on their footprint, which is worth knowing before the money leaves your hand.
A closer look at real water volume
The gallon number on the box is a starting figure, not the water you actually keep. Substrate takes up space, and a couple of inches of gravel or sand across the bottom removes real volume. Rocks, driftwood, and decorations displace more. Equipment inside the tank adds up. And you never fill to the very rim, leaving a gap below the trim and for the lid. Add it together and a nominal 20 gallon tank often holds closer to 17 gallons of water, sometimes less in a heavily aquascaped setup.
This matters because every calculation of bioload and oxygen rests on the true water volume, not the label. It is one more reason to stay well under any calculated ceiling. When you treat the result as a maximum you avoid rather than a target you hit, the gap between labelled and real volume becomes a safety margin instead of a nasty surprise. Conservative stocking, generous filtration, and steady water changes together keep the tank forgiving.
If you want to check the arithmetic yourself, a tank's volume in US gallons is its length times width times height in inches, divided by 231. A 30 by 12 by 12 inch tank works out at 18.7 gallons, which is why a 20 gallon long has never really been twenty gallons. The unit converter handles the switch to litres if your tank came with metric measurements.
Why understocking beats overstocking
It is tempting to fill a new tank fast, but a lightly stocked aquarium is the one that thrives. With fewer fish your filter and bacteria have easy work, ammonia and nitrite stay at zero, nitrate climbs slowly between water changes, and oxygen stays plentiful. There is room for fish to reach full size, space that reduces aggression, and a buffer for the inevitable mistakes: a missed water change, an overfeeding, a fish that gets sick. Problems that would crash a crowded tank barely register in an understocked one.
An overstocked tank is the opposite in every way. The filter cannot keep up, waste accumulates, oxygen runs low, fish grow stressed and stunted, disease spreads fast in the crowd, and territorial fights break out over cramped space. Every maintenance session becomes damage control.
Given the choice, err on the side of fewer fish. The tank will be healthier, the fish will live longer, and the hobby will be far more enjoyable. That bias toward caution is baked into how this tool reasons, and it is the single most useful habit a new fishkeeper can adopt. If your plan lands under 85 percent with every school at its proper size and something living on the bottom, you have a tank you can keep rather than a tank that keeps you busy.
Your data stays on your device
Everything you enter into the aquarium stocking calculator, your tank size, your filter, your fish list, stays in your browser. Nothing is uploaded to a server, nothing is stored on our end, and there is no account collecting your plans. When you close the tab the session ends and the data is gone. You can sketch out a dozen different tanks and know that none of those details ever left your screen. Privacy is simply how the tool is built, not a feature you have to find and switch on.
Free with no strings attached
The tool is genuinely free to use. There is no sign-up, no account, no email capture, and no premium tier that hides the useful parts behind a paywall. Every species, every factor, and every stocking estimate is available to anyone who opens the page. You will not build half a plan and then hit a wall demanding payment. Free here means the whole tool, for as long as you want it, with nothing held back.
Instant, unlimited, and light on your device
Because the calculating happens on your own device, the stocking level updates the moment you add a fish or change the tank, with no spinner and no server round-trip. There is no cap on how many plans you can run, so compare tanks and fish lists to your heart's content. The page is deliberately lightweight and free of the heavy scripts that slow so many hobby sites, so it loads quickly and stays snappy even on an older phone in a fish store aisle.
Works on any device, even offline
The tool runs on whatever you have with you, a phone at the aquarium store, a tablet by the tank, or a laptop while you plan an upgrade. Since the logic lives in your browser rather than on a remote server, it keeps working without a connection. Once the page has loaded you can lose signal and still add fish, change tanks, and read the warnings. That is handy exactly when you need it most, standing in front of a tank of fish deciding what fits your setup at home.
Related ToolFiddle tools
A few other free ToolFiddle tools pair well with fishkeeping. If you keep a reef tank that needs supplements, the reef dosing calculator works out your doses. The unit converter switches tank volumes between gallons and litres and dimensions between inches and centimetres. Track your water change and maintenance intervals with the days between dates calculator, and time a treatment, a feeding, or a drip acclimation with the timer. For quick water-change and stocking-share math, the percentage calculator is handy too. Each one runs on your device with the same privacy-first design.
Quick recap
The aquarium stocking calculator estimates how many fish your tank can safely hold by weighing real water volume, tank shape, filtration, adult fish size, bioload, and social needs, rather than counting inches. It reports two limits, the waste your filter has to process and the swimming room your fish need, and the honest answer is whichever fills first. The old one inch per gallon rule is a rough gut check at best and misleads badly with large or messy fish. Cycle your tank first, stock slowly, plan for adult sizes, respect schooling minimums and territorial needs, and lean toward understocking for a stable, forgiving system. The tool is free, private, instant, and works on any device even offline, so you can plan responsibly before you buy. Always research each species and watch your own water parameters.