Aquarium Fish Compatibility Checker
Compatibility verdict
How the answer was worked out
Plan the rest of the setup: our Aquarium Salt Mix Calculator works out salt doses for a water change, our Aquarium Fish Food Cost Calculator prices feeding the tank, and our Planted Aquarium Dosing and CO2 Calculator covers fertilizer and carbon dioxide for a planted tank.
Last reviewed: 20 November 2026. Reviewed every 180 days; next review due 19 May 2027.
How to use the Aquarium Fish Compatibility Checker
The most common beginner mistake in fishkeeping is mixing fish that should never share a tank. A fish that looks peaceful in a shop tank can eat its tankmates when it grows, nip their fins to shreds, or slowly fail because the water is the wrong temperature or the wrong hardness for it. This checker answers the question every aquarist asks before buying a new fish: can this fish live with that fish? It scores a pair of species from their published care ranges, or it checks a whole tank's stocking at once, and it shows its working so you can see exactly why a pair passes or fails.
The checker covers 24 of the most commonly kept freshwater aquarium species, from neon tetras and guppies to oscars and clown loaches. Every species carries its published temperature range, pH range, water hardness range, adult size, minimum group size, and minimum tank size, taken from Seriously Fish species profiles, with FishBase, LiveAquaria, and Aqueon care guides as cross-checks. The score is built from those ranges, plus what is known about each species' temperament, fin-nipping habits, and predatory behavior. Nothing in the checker is guessed: where sources disagree, the governing source is named in the sources section below, and the few values that come from a different source are flagged there too.
To check two fish, follow these steps:
- Pick the first species. Use the first dropdown in the "Check two fish" panel. The list is alphabetical by common name, with the scientific name in brackets, so you can be sure you have the right fish. Some common names cover more than one species: the Black Skirt Tetra is also sold as the Black Widow Tetra, and the Kuhli Loach sold in shops is usually Pangio semicincta rather than the true Pangio kuhlii. The checker uses the species as Seriously Fish profiles it.
- Pick the second species. Use the second dropdown. The two species must be different: the checker refuses to compare a species with itself, because the interesting question is always about two different fish.
- Read the verdict. The result appears as soon as both species are chosen. The verdict is one of four: Compatible, Compatible with care, Risky, or Not compatible. Below the verdict, four cards show the score for temperature, pH, temperament, and size, each out of its own maximum, and a bar shows the total score out of 100. The guidance paragraph explains the result in plain words, and the steps list shows the arithmetic behind every point.
- Check the warnings. A pair can pass with a high score and still carry warnings that matter. A narrow shared temperature range, a pH overlap that touches at exactly one value, a hardness mismatch, or a species-specific warning (a dwarf gourami iridovirus note, for example) all appear in the "Things to watch" box. Read them before you buy.
- Note the recommended water. When a pair is compatible, the result gives a recommended temperature and pH: the midpoint of the shared range for each. Those are starting points for your heater and your water tests, not targets to chase to the decimal. A stable temperature inside the shared range matters more than hitting the midpoint exactly.
To check a whole tank, switch to the "Check a whole tank" panel and follow these steps:
- Add each species and how many you keep. Each row takes one species and a count. You can list up to six species. If you list the same species on two rows, the checker merges the counts, so a split entry still gives the right total.
- Enter your tank size in gallons. Use the tank's nominal size: a standard 20-gallon tank is 20 gallons, even though the water volume is a little less once substrate and decorations are in. The checker accepts tanks from 1 to 10,000 gallons.
- Read the overall verdict. The checker compares every pair in the tank and reports the worst pair, because one bad pairing is enough to ruin a tank. The overall verdict starts from that worst pair and drops one band for each stocking problem: a schooling species kept below its minimum group, a tank smaller than a species' minimum, or a tank over the rough one-inch-per-gallon stocking guide. The pair table lists every pair with its own score and verdict, so you can see which fish is the problem and which pairs are fine.
- Check the stocking figures. The result shows the total adult size of all your fish in inches, the inches per gallon, the largest minimum tank size among your species, and any schooling shortfalls. These are the numbers that decide whether a tank is comfortable or crowded, and they are the numbers most beginners never add up.
The example buttons under the form load ready-made checks: a classic neon and cardinal pairing, the angelfish and neon mistake, the tiger barb and betta clash, and a whole-tank example with neons, corydoras, and a bristlenose pleco. Try them to see how the checker explains a good pairing, a predation problem, and a fin-nipping problem. The results update live as you change any input, so you can swap species in and out and watch the verdict move.
How the compatibility score works
Every pair is scored out of 100, built from four parts: temperature (25 points), pH (20 points), temperament (30 points), and size (25 points). The four parts are added, then hard gates and downgrades are applied. A hard gate forces the verdict to Not compatible whatever the score. A downgrade drops the verdict one band: Compatible becomes Compatible with care, Compatible with care becomes Risky, and Risky becomes Not compatible. The steps list in the result shows every part of the arithmetic, so nothing is hidden.
Temperature: 25 points. The checker finds the overlap between the two species' published temperature ranges. A shared range of 6 degrees Fahrenheit or more scores the full 25 points. An overlap of 4 to 5 degrees scores 22, 2 to 3 degrees scores 15, and 1 degree scores 8. If the ranges do not overlap at all, the pair scores 0 for temperature and the temperature hard gate fires: the verdict is Not compatible, because there is no water temperature both fish can live in. A narrow overlap also earns a warning, because a shared range of 1 or 2 degrees leaves no room for a heater that drifts or a hot summer day.
pH: 20 points. The checker finds the overlap between the two species' published pH ranges. An overlap of 1.5 pH units or more scores the full 20 points. An overlap of 1.0 to 1.4 scores 17, 0.5 to 0.9 scores 12, and 0.2 to 0.4 scores 7. If the ranges touch at exactly one pH value, the overlap is 0.0 and the pair scores 4 points with a warning: the fish can only share water at a single pH, which is hard to hold steady. If the ranges do not overlap at all, the pair scores 0 and the pH hard gate fires. In this set of 24 species, no pair has truly disjoint pH ranges, so the pH gate never fires in practice, but it is there for completeness.
Temperament: 30 points. Each species carries an aggression rating from 1 (peaceful) to 4 (very aggressive), set from Seriously Fish temperament notes. The temperament score starts at 30 and loses 8 points for each step of difference between the two ratings, plus 4 points if the more aggressive species is rated 3 or 4. Two peaceful fish score 30. A peaceful fish with a moderately aggressive fish loses points for the gap. Two aggressive fish score less than two peaceful fish, because even matched aggression means chasing, stress, and torn fins. The rating is a species-level guide: individual fish vary, and a breeding pair of cichlids is far more aggressive than the same fish outside breeding season.
Size: 25 points. The checker divides the larger fish's adult size by the smaller fish's adult size. A ratio of 2 or less scores 25, 3 or less scores 22, 4 or less scores 18, 6 or less scores 14, and anything larger scores 8. But size is also where predation lives. If the larger fish is predatory and the size ratio is 3 or more, the predation hard gate fires: the verdict is Not compatible, because the larger fish can eat the smaller one. If the larger fish is predatory and the ratio is between 2 and 3, the size score is 0 unless the smaller fish is armored or deep-bodied, in which case it scores normally: a bronze corydoras is protected by its bony plates, a bristlenose pleco by its armor and its habit of hiding, and a black skirt tetra by its deep, rounded body, which is why Seriously Fish notes that a black skirt is unlikely to end up as angelfish food.
The verdict bands turn the score into a plain verdict:
| Score | Verdict | What it means |
|---|---|---|
| 85 to 100 | Compatible | The pair shares water and temperament. Keep the tank in the shared ranges and the pair should thrive. |
| 70 to 84 | Compatible with care | The pair can work, but something needs attention: a narrow temperature overlap, a temperament gap, or a size difference. Read the warnings. |
| 50 to 69 | Risky | The pair is a gamble. It may work in a large, well-planted tank with hiding places, but it may also end in stress, injury, or a missing fish. |
| Below 50 | Not compatible | Do not keep these fish together. The score is low because the water, the temperament, or the size gap is wrong. |
Hard gates. Four conditions override the score entirely and force a Not compatible verdict. The temperature gate fires when the temperature ranges do not overlap. The pH gate fires when the pH ranges do not overlap. The predation gate fires when a predatory fish is at least three times the size of its tankmate. The fin-nipping gate fires when a severe fin-nipper, the tiger barb, is paired with a long-finned species: a betta, a guppy, an angelfish, or a dwarf gourami. The gates are checked in that order, and the result names the gate that fired, so you know exactly which problem killed the pairing.
Downgrades. Three kinds of problem drop the verdict one band without changing the score. A hardness downgrade fires when the two species' hardness ranges overlap by less than 1 dGH, or do not overlap at all: two fish can share a pH and still need very different water hardness, and the classic case is a molly with a neon tetra, covered in the worked examples below. A fin-harassment downgrade fires when a severe fin-nipper is paired with a small, vulnerable fish such as a neon or cardinal tetra: the nipper does not gate the pair, but the small fish will be harassed. A clash downgrade fires for two known species clashes: a male dwarf gourami may turn aggressive toward a betta or toward a guppy, and a male betta may treat another long-finned fish as a rival. The result lists every downgrade that applied, so you can see whether the verdict dropped because of water, behavior, or both.
Worked examples
Every number below comes from the checker itself. Run any of these pairs through the tool and you will see the same figures in the steps list.
Neon Tetra and Cardinal Tetra: 97, Compatible. The two tetras share 4 degrees of temperature (73 to 77 degrees Fahrenheit), which scores 22 of 25 for temperature. They share 3.5 pH units (4.0 to 7.5), which scores the full 20 for pH. Both are rated aggression 1, so temperament scores the full 30. The size ratio is 1.2 (a 1.4-inch cardinal against a 1.2-inch neon), which scores the full 25. Total: 22 plus 20 plus 30 plus 25 equals 97. No gate fires and no downgrade applies. The recommended water is 75.0 degrees Fahrenheit and pH 5.8, the midpoints of the shared ranges, and the pair needs at least a 14-gallon tank.
Angelfish and Neon Tetra: 42, Not compatible. The two fish share 2 degrees of temperature (75 to 77 degrees Fahrenheit), which scores 15 for temperature, and 1.4 pH units (6.0 to 7.4), which scores 17 for pH. Temperament scores 10: the aggression gap is 2 (angelfish 3, neon 1), so the score is 30 minus 16 for the gap minus 4 because the angelfish is rated 3. Size scores 0, because the angelfish is predatory and the size ratio is 5.0, a 6-inch angelfish against a 1.2-inch neon. Total: 15 plus 17 plus 10 plus 0 equals 42. The score alone would put the pair in the Not compatible band, and the predation gate fires as well, because a predatory fish at least three times the size of its tankmate will eat it. This is the classic beginner mistake: the angelfish is small when bought, the neons vanish one by one as it grows, and the owner blames disease. The minimum tank for the pair is 53 gallons, driven by the angelfish.
Molly and Neon Tetra: 89, Compatible with care. The score is high: temperature shares 7 degrees and scores 25, pH shares 0.5 units (7.0 to 7.5) and scores 12, temperament scores 30 because both fish are rated aggression 1, and the size ratio of 2.6 scores 22. Total: 25 plus 12 plus 30 plus 22 equals 89, which is a Compatible score. But the verdict drops to Compatible with care, because the hardness ranges do not overlap at all: mollies need 15 to 30 dGH, neons need 1 to 12 dGH, so the overlap is minus 3 dGH. The two fish can share a pH of 7.0 to 7.5, but they cannot share water hardness. Keep them together and one of them lives in water that is wrong for it: the molly in soft water, or the neon in hard water. This is why the checker scores hardness separately from pH, and why a high score is not the whole story.
Tiger Barb and Betta: 96, Not compatible. This pair shows why hard gates exist. The score is 96: temperature shares 7 degrees and scores 25, pH shares 2.0 units and scores 20, temperament scores 26 because both fish are rated aggression 3 (30 minus 0 for the gap, minus 4 because the maximum rating is 3), and the size ratio of 1.2 scores 25. Total: 25 plus 20 plus 26 plus 25 equals 96, the highest score of any incompatible pair in the checker. But the fin-nipping gate fires: tiger barbs are notorious fin-nippers, and a betta's long flowing fins are the perfect target. The verdict is Not compatible, whatever the score says. The same gate fires for a tiger barb with a guppy, an angelfish, or a dwarf gourami, because male dwarf gouramis develop extended dorsal and anal fins.
Kuhli Loach and Platy: 84, Risky. The score is 84: temperature shares 9 degrees and scores 25, temperament scores 30 because both fish are rated aggression 1, and the size ratio of 2.0 scores 25. But pH scores only 4, because the two ranges touch at exactly one value: kuhli loaches need pH 3.5 to 7.0, platies need pH 7.0 to 8.2, so the overlap is 0.0 at pH 7.0. Total: 25 plus 4 plus 30 plus 25 equals 84, which is a Compatible with care score. The verdict then drops to Risky, because the hardness ranges do not overlap: kuhli loaches need 0 to 8 dGH, platies need 10 to 30 dGH, an overlap of minus 2 dGH. The pair needs water held at exactly pH 7.0 with hardness that suits neither fish. That is a risky combination, and the checker says so.
Betta and Guppy: 77, Risky. The score is 77: temperature shares 10 degrees and scores 25, pH shares 1.0 unit (7.0 to 8.0) and scores 17, temperament scores 10 because the aggression gap is 2 (betta 3, guppy 1) and the maximum rating is 3, and the size ratio of 1.2 scores 25. Total: 25 plus 17 plus 10 plus 25 equals 77, which is a Compatible with care score. The verdict drops to Risky because a male betta may treat a guppy as a rival: the guppy's bright colors and flowing tail look like another betta to a territorial male. Some individual bettas ignore guppies, which is why the pair is Risky rather than Not compatible, but the combination fails often enough that the checker downgrades it.
A whole tank: 8 neons, 6 bronze corydoras, and 1 bristlenose pleco in 20 gallons: Compatible with care. The checker compares three pairs. Neon and corydoras score 97, Compatible. Neon and bristlenose score 89, Compatible, with the size ratio of 4.2 costing points. Corydoras and bristlenose score a perfect 100. The worst pair is neon and bristlenose at 89, so the tank starts at Compatible. But the stocking total is 32.6 inches of adult fish: 8 neons at 1.2 inches (9.6 inches), 6 corydoras at 3.0 inches (18.0 inches), and 1 bristlenose at 5.0 inches (5.0 inches). In 20 gallons that is 1.63 inches per gallon, over the rough one-inch-per-gallon guide, so the verdict drops one band to Compatible with care. The tank size is fine: the largest minimum is the corydoras at 19 gallons, and the tank is 20 gallons. Every schooling species has a big enough group. The only problem is the total load, and the fix is a bigger tank, fewer fish, or stronger filtration and more frequent water changes.
What the score does not cover
The checker scores what published care ranges can tell you. It does not score everything that matters in a real tank, and the notes in every result say so. The most important gap is individual variation. A species rating is an average over thousands of fish. Individual bettas range from peaceful to murderous. Individual tiger barbs range from model community fish to relentless fin-nippers. A Compatible verdict means the species usually work together, not that your two particular fish will. Watch the tank for a week after any introduction, and have a spare tank or a divider ready in case a fish needs to be separated.
Tank layout changes behavior more than any score can capture. A tank with dense plants, driftwood, rocks, and broken lines of sight lets weaker fish escape attention, and it lets territorial fish claim separate areas. A bare tank with one ornament forces every fish into the same open water, and the same species that are peaceful in a planted tank can turn nasty in a bare one. The checker assumes a normally decorated tank with hiding places. If your tank is bare, treat every verdict as one band worse than shown.
Sex ratios matter for livebearers and for cichlids, and the checker does not ask about them. Male guppies, platies, swordtails, and mollies harass females relentlessly if the ratio is wrong: keep at least two females per male for livebearers, and never keep a single female with several males. Male swordtails fight each other. Male dwarf gouramis are territorial toward each other, and two males in a small tank is a recipe for disaster, in Seriously Fish's words. The checker scores the species pair, not your particular mix of males and females, so the sex-ratio rules sit on top of the score.
Breeding changes everything. Convict cichlids are rated aggression 4 for a reason: a breeding pair becomes violent toward any fish that comes near the nest, and Seriously Fish recommends a species tank for a breeding pair. Angelfish pairs defend their eggs. Even peaceful cichlids such as German blue rams defend a spawning site. A pair that scores Compatible can still fail when one species starts breeding, so if you keep cichlids, plan for the breeding season, not just for the quiet months.
Water chemistry goes beyond temperature, pH, and hardness. Ammonia, nitrite, and nitrate are the numbers that actually kill fish, and they depend on your filter, your feeding, and your water changes, not on which species you keep. A cycled filter, a test kit, and regular water changes matter more than any compatibility score. The checker also does not cover disease: dwarf gourami iridovirus, which has no cure, is flagged in the dwarf gourami warning, but every new fish should be quarantined for two to four weeks before it joins the main tank, whatever the checker says. Our Aquarium Salt Mix Calculator helps with the salt baths and dips that are part of quarantine and treatment, and our Aquarium Fish Food Cost Calculator works out what feeding the tank actually costs per month.
Finally, the checker uses wild maximum standard lengths for adult size, because that is the figure Seriously Fish publishes. Most aquarium fish stay smaller than the wild maximum: a clown loach can reach 16 inches in the wild, but most captive specimens reach 8 to 12 inches. The score uses the maximum because a tank should be planned around the largest fish it might hold, not the smallest. If a pair scores low on size because one fish has a large wild maximum, that is a planning caution, not a prediction that your fish will reach that size.
The 24 species in the checker
The table below lists every species the checker covers, with the published care ranges the score is built from. Temperatures are in degrees Fahrenheit, hardness in degrees of general hardness (dGH), adult size in inches of standard length, and minimum tank size in US gallons. The minimum group is the smallest group the species should be kept in: a value of 1 means the species is fine alone or in a pair, and a higher value means a schooling species that suffers alone.
| Species | Temperature | pH | Hardness | Adult size | Minimum group | Minimum tank |
|---|---|---|---|---|---|---|
| Angelfish | 75-86 °F | 6.0-7.4 | 0-15 dGH | 6 in | 1 | 53 gal |
| Betta | 72-86 °F | 6.0-8.0 | 1-15 dGH | 2.8 in | 1 | 11 gal |
| Black Skirt Tetra | 68-79 °F | 6.0-7.0 | 5-20 dGH | 2.4 in | 6 | 18 gal |
| Bristlenose Pleco | 70-79 °F | 5.5-7.5 | 1-15 dGH | 5 in | 1 | 14 gal |
| Bronze Corydoras | 70-81 °F | 6.0-8.0 | 2-15 dGH | 3 in | 6 | 19 gal |
| Cardinal Tetra | 73-84 °F | 3.5-7.5 | 1-12 dGH | 1.4 in | 8 | 14 gal |
| Cherry Barb | 68-81 °F | 6.0-8.0 | 2-20 dGH | 2 in | 6 | 14 gal |
| Clown Loach | 75-86 °F | 5.0-7.0 | 1-12 dGH | 16 in | 5 | 171 gal |
| Convict Cichlid | 75-82 °F | 6.0-8.0 | 5-25 dGH | 6 in | 1 | 21 gal |
| Discus | 79-86 °F | 5.0-7.0 | 0-5 dGH | 6 in | 6 | 67 gal |
| Dwarf Gourami | 72-81 °F | 6.0-7.5 | 2-18 dGH | 3.5 in | 1 | 15 gal |
| German Blue Ram | 81-86 °F | 4.0-7.0 | 1-10 dGH | 1.6 in | 1 | 14 gal |
| Goldfish | 60-74 °F | 7.0-8.4 | 5-19 dGH | 8 in | 5 | 20 gal |
| Guppy | 63-82 °F | 7.0-8.5 | 8-30 dGH | 2.4 in | 1 | 11 gal |
| Harlequin Rasbora | 70-82 °F | 5.0-7.5 | 1-12 dGH | 1.8 in | 8 | 14 gal |
| Kuhli Loach | 70-79 °F | 3.5-7.0 | 0-8 dGH | 3.9 in | 6 | 14 gal |
| Molly | 70-82 °F | 7.0-8.5 | 15-30 dGH | 3.1 in | 1 | 21 gal |
| Neon Tetra | 70-77 °F | 4.0-7.5 | 1-12 dGH | 1.2 in | 8 | 14 gal |
| Oscar | 68-82 °F | 6.0-7.5 | 5-20 dGH | 14 in | 1 | 143 gal |
| Platy | 68-79 °F | 7.0-8.2 | 10-30 dGH | 2 in | 1 | 14 gal |
| Swordtail | 61-82 °F | 7.0-8.0 | 10-25 dGH | 6 in | 1 | 29 gal |
| Tiger Barb | 68-79 °F | 5.0-8.0 | 1-20 dGH | 2.4 in | 6 | 19 gal |
| White Cloud Mountain Minnow | 57-72 °F | 6.0-8.5 | 5-20 dGH | 1.6 in | 10 | 14 gal |
| Zebra Danio | 64-77 °F | 6.0-8.0 | 5-20 dGH | 2 in | 8 | 21 gal |
A few entries in the table need explanation. The goldfish has no Seriously Fish profile, so its values come from FishBase and the Aqueon goldfish care guide instead: the temperature range of 60 to 74 degrees Fahrenheit spans the Aqueon figures for comets (60 to 70 degrees) and fancy goldfish (68 to 74 degrees), the pH range of 7.0 to 8.4 is Aqueon's ideal, the hardness range of 5 to 19 dGH is FishBase's, the adult size of 8 inches is the usual aquarium adult size rather than FishBase's wild maximum of 48 centimeters, and the 20-gallon minimum is Aqueon's figure for one adult common or comet goldfish. The harlequin rasbora's ranges come from the same published aquarium ranges quoted across the hobby's reference sites, with FishBase's wild habitat figures (22 to 25 degrees Celsius, pH 5.0 to 7.0) as a cross-check: wild habitat ranges are narrower than aquarium care ranges, and the checker uses the aquarium ranges.
Three minimum tank sizes in the table are derived rather than printed. The discus minimum of 67 gallons comes from Seriously Fish's recommendation of 255 liters for a few juveniles or a pair, which is 67.4 US gallons. The convict cichlid minimum of 21 gallons comes from Seriously Fish's statement that base dimensions of 90 by 30 centimeters are adequate for a single pair, which is the same footprint as the 81-liter tanks listed at 21 gallons for other species. The dwarf gourami minimum of 15 gallons comes from Seriously Fish's note that a 56-liter tank is just about big enough for a pair. Every other minimum tank size is the US gallon figure Seriously Fish prints in the species profile.
Scientific names follow Seriously Fish, which is the governing source, even where taxonomy has moved on. The bronze corydoras is listed by Seriously Fish as Osteogaster aenea, long known in the hobby as Corydoras aeneus. The cherry barb is Puntius titteya on Seriously Fish, now Rohanella titteya in the Catalog of Fishes. The dwarf gourami is Trichogaster lalius on Seriously Fish, now Trichogaster fasciata in the Catalog of Fishes. The bristlenose pleco sold in shops as Ancistrus cf. cirrhosus is profiled by Seriously Fish as Ancistrus sp. '3', because the true identity of the aquarium strain is unknown. The kuhli loach sold as Pangio kuhlii is profiled by Seriously Fish as Pangio semicincta, because the true Pangio kuhlii is endemic to Java and possibly never seen in aquaria. The checker uses common names in the dropdowns, with the Seriously Fish scientific name in brackets, so the names match the source of the data.
Classic pairings and classic mistakes
Discus and cardinal tetras: 86, Compatible. This is the pairing Seriously Fish itself names: the German blue ram profile lists cardinals as suitable tankmates for warm, soft-water tanks, and the discus and cardinal combination is a staple of the planted show tank. The two fish share 5 degrees of temperature (79 to 84 degrees Fahrenheit) and 2.0 pH units (5.0 to 7.0), both are rated aggression 1, and the size ratio of 4.3 costs points but does not gate the pair, because the discus is not predatory. The score is 22 plus 20 plus 30 plus 14, which is 86. The pair needs a 67-gallon tank and very soft, warm, clean water, so it is not a beginner combination, but the two species belong together.
Goldfish and bristlenose pleco: 89, Compatible. The two fish share 4 degrees of temperature (70 to 74 degrees Fahrenheit) and 0.5 pH units (7.0 to 7.5), both are rated aggression 1, and the size ratio of 1.6 scores the full 25. The score is 22 plus 12 plus 30 plus 25, which is 89. The bristlenose is armored, so the goldfish's predatory rating does not cost size points, and the bristlenose's algae-eating habit suits a goldfish tank. The pair needs at least 20 gallons, and the goldfish warning applies: goldfish produce far more waste than tropical fish, so the tank needs strong filtration and large weekly water changes.
Angelfish and bronze corydoras: 77, Compatible with care. The two fish share 6 degrees of temperature and 1.4 pH units, and the size ratio is exactly 2.0, a 6-inch angelfish against a 3-inch corydoras. The score is 25 plus 17 plus 10 plus 25, which is 77. The temperament score is 10 because the aggression gap is 2 and the angelfish is rated 3. The size score is the full 25, even though the angelfish is predatory and the ratio is 2.0, because the corydoras is armored: its bony plates protect it, and it spends its time on the tank floor while the angelfish patrols the middle and top. This is a classic community pairing, and the checker scores it as one.
Goldfish and tropical fish: the coldwater mistake. Goldfish are coldwater fish, and most of the species in the checker are tropical. A goldfish with a white cloud mountain minnow scores 72 but is Not compatible, because the predation gate fires: a goldfish is predatory and 5.0 times the size of a 1.6-inch minnow. A goldfish with a neon tetra scores 64 and the predation gate fires as well, with a ratio of 6.7. A goldfish with a zebra danio scores 72 and the predation gate fires, with a ratio of 4.0. The temperature ranges overlap in all three cases, which is why beginners make the mistake: the fish look fine together in the shop, and the small fish vanish as the goldfish grows. Goldfish belong with other goldfish, or with armored cool-water tankmates such as the bristlenose pleco. If you keep goldfish in a pond rather than a tank, our Koi Pond Feeding Calculator and Pond Build Cost Calculator cover the pond side of the hobby.
Discus and neon tetras: the temperature mistake. Discus need 79 to 86 degrees Fahrenheit. Neons need 70 to 77 degrees. The ranges do not overlap at all, so the temperature gate fires and the verdict is Not compatible, with a score of 64. The two fish look as if they belong together, and both are soft-water Amazon species, but the discus needs water 2 degrees warmer than the warmest water a neon tolerates. Cardinals, which need 73 to 84 degrees, are the right tetra for a discus tank, not neons.
Tiger barbs and anything long-finned: the fin-nipping mistake. Tiger barbs are rated aggression 3 and are notorious fin-nippers. With a betta they score 96 and still fail, because the fin-nipping gate fires. With a guppy, an angelfish, or a dwarf gourami the gate fires too. With small fish such as neons and cardinals the gate does not fire, but the verdict drops one band, because the small fish will be harassed: tiger barb and neon scores 80 and drops to Risky. Tiger barbs belong with fast, robust, short-finned fish in a group of at least 6, which spreads the nipping among the group. Kept in a group that is too small, they turn on their tankmates.
Bettas and other long-finned fish: the rival mistake. A male betta treats another long-finned fish as a rival. Betta and guppy scores 77 and drops to Risky. Betta and angelfish scores 68 and drops to Not compatible, because the temperament gap and the rival downgrade together push the verdict over the edge. Betta and dwarf gourami scores 88 and drops to Compatible with care, because a male dwarf gourami may also turn aggressive toward a betta: two territorial anabantoids in one tank is a clash from both directions. Seriously Fish says the betta is best kept alone, and the checker agrees: a betta with peaceful, short-finned, non-glossy tankmates such as corydoras or kuhli loaches is a better combination than a betta with anything bright and flowing.
Convict cichlids and oscars: the size mistake. Convict cichlids and oscars are both rated aggression 4, and both are predatory. An oscar grows to 14 inches and needs a 143-gallon tank. A convict cichlid grows to 6 inches and becomes violent when breeding. Either fish with a small community fish triggers the predation gate. A convict cichlid with a bronze corydoras scores 70, Compatible with care, because the corydoras is armored and the ratio is 2.0, but that is the edge of what works: the corydoras survives because of its armor, not because the convict is gentle. An oscar with a clown loach scores 73, Compatible with care, because the clown loach grows to 16 inches and is too big to eat. Big fish need big tanks and big tankmates, and the checker scores size first for a reason.
Stocking a community tank
Compatibility is only half of stocking. The other half is how many fish the tank can hold, and the checker covers that in tank mode with three separate checks: the inch-per-gallon guide, the schooling minimums, and the tank-size minimums. Each check drops the overall verdict one band when it fails, because each one is a real welfare problem on its own.
The inch-per-gallon guide. The oldest rule in the hobby says a tank can hold about one inch of adult fish per gallon of water. A 20-gallon tank holds about 20 inches of fish. The checker adds up the adult size of every fish in the tank and divides by the tank size: if the result is over 1.0 inches per gallon, the tank is overstocked and the verdict drops one band. The guide is rough, and the checker says so in every tank result. It ignores body mass: a 3-inch corydoras and a 3-inch goldfish are not the same load, because the goldfish is far heavier and produces far more waste. It ignores surface area: a long, shallow tank holds more fish than a tall, narrow tank of the same volume, because gas exchange happens at the surface. And it ignores filtration: a tank with a large filter and weekly water changes holds more fish than the same tank with a small filter and monthly changes. Use the guide as a warning light, not as a law. If the checker says your tank is over the guide, the fix is a bigger tank, fewer fish, stronger filtration, or more frequent water changes, in that order of preference.
Schooling minimums. Schooling fish kept alone or in too small a group are stressed, shy, and prone to disease, and some turn aggressive. The checker flags every species kept below its minimum group. The minimums in the checker are: neon tetra 8, cardinal tetra 8, zebra danio 8, harlequin rasbora 8, white cloud mountain minnow 10, tiger barb 6, cherry barb 6, black skirt tetra 6, bronze corydoras 6, kuhli loach 6, discus 6, goldfish 5, clown loach 5. The white cloud minimum of 10 comes from Seriously Fish, which recommends a group of 10 or more. The black skirt minimum of 6 is the floor for a healthy group; Seriously Fish notes that fin-nipping in black skirts can usually be fixed by keeping a shoal of at least 12, which is a cure for a behavior problem, not the minimum group size. The checker uses the minimum, and the black skirt warning covers the fin-nipping side. Buy schooling fish in the full group at once if you can: adding two fish a month to a group of eight leaves the first fish stressed for months.
Tank-size minimums. Every species in the checker carries a minimum tank size, and the tank check compares your tank against the largest minimum in the list. The minimums are floors, not targets. A 20-gallon tank is the minimum for a goldfish, not a comfortable home for one: a goldfish in a 20-gallon tank needs strong filtration and weekly water changes, and it will be happier in 40 gallons. The same applies to every species. Bigger tanks are also easier to keep: the water chemistry is more stable, the temperature swings less, and a missed water change matters less. If the checker says your tank is too small for a species, the answer is a bigger tank or a different species, not a hope that the fish will stay small. Fish do not grow to the size of their tank: they grow to their adult size, and a tank that is too small stunts them, stresses them, and shortens their lives.
Adding order. Add the peaceful species first and the territorial species last. A betta or a dwarf gourami that arrives in an established tank is less likely to claim the whole tank as its territory than one that has lived alone in it for months. Add schooling fish in their full group. Add bottom-dwellers such as corydoras and kuhli loaches after the mid-water fish, so they find an established tank with food reaching the floor. Never add all the fish at once: a new filter needs time to build up the bacteria that process waste, and adding a full stocking on day one overwhelms it. Add a few fish, wait a week, test the water, and add the next group.
Quarantine. Every new fish should spend two to four weeks in a separate quarantine tank before it joins the main tank. Quarantine catches disease before it spreads, and it gives a stressed fish time to recover from transport and start eating. A quarantine tank does not need to be large or pretty: a 10-gallon tank with a sponge filter, a heater, and a hiding place is enough for most species. The checker flags the dwarf gourami iridovirus risk in the dwarf gourami warning, but quarantine protects against every disease, not just that one. If you cannot quarantine, buy from a shop you trust, watch the fish in the shop tank for a few minutes before buying, and never buy a fish from a tank that has a dead fish in it.
Plants and layout. A planted tank is a more forgiving tank. Plants consume nitrate, provide hiding places, break up lines of sight, and give shy fish somewhere to retreat. A tank with dense planting can hold pairings that would fail in a bare tank, and it can hold a slightly higher stocking level, because the plants process waste. Our Planted Aquarium Dosing and CO2 Calculator works out fertilizer dosing and carbon dioxide for a planted tank. If you are setting up a saltwater tank instead, the rules in this checker do not apply: saltwater fish have different water chemistry, different compatibility rules, and different costs, and our Reef Tank Setup Cost Calculator covers the budget side of a reef tank.
Features
- Pair mode. Compare any two of 24 species and get a verdict, a score out of 100, four sub-scores, a recommended temperature and pH, and the minimum tank size for the pair.
- Tank mode. List up to six species with counts, enter your tank size, and get an overall verdict, a pair-by-pair table, stocking totals, schooling shortfalls, and tank-size checks.
- Transparent scoring. Every point is shown in the steps list: temperature, pH, temperament, and size sub-scores, the total, and every gate and downgrade that applied. No black box.
- Hard gates that override the score. Temperature, pH, predation, and fin-nipping gates force a Not compatible verdict when the pairing is dangerous, even if the score is high.
- Species-specific warnings. Dwarf gourami iridovirus, goldfish waste, discus water needs, convict cichlid breeding aggression, oscar and clown loach adult size, and more, drawn from the species profiles.
- Schooling and stocking checks. Tank mode checks every schooling minimum, the inch-per-gallon guide, and the largest minimum tank size, and names the species that fails each check.
- Live recalculation. Change any input and the result updates immediately, so you can try different combinations and watch the verdict move.
- Worked examples. Example buttons load a classic pairing, a predation mistake, a fin-nipping clash, and a whole-tank stocking, so you can see how the checker explains each kind of result.
- Published data only. Every species value comes from Seriously Fish species profiles, with FishBase, LiveAquaria, and Aqueon as cross-checks. No invented figures, and the sources section names the governing source for every value.
- Mobile friendly. The checker works on a phone, so you can check a pairing in the fish shop before you buy.
Use cases
Buying your first fish. A new tank owner with a 20-gallon tank and a list of fish they like can check every pair before buying, and check the whole stocking in tank mode before the first fish goes in. The checker catches the two mistakes beginners make most: mixing a predator with small fish, and mixing fish that need different water.
Adding to an existing tank. You have a tank of neons and corydoras and you are tempted by a betta in the shop. Check the betta against each species you already keep: betta and neon scores 74, Compatible with care, and betta and corydoras scores well, so the combination is plausible, but the betta warning tells you the betta is best kept alone and may not tolerate tankmates at all. That is the information you need before you buy, not after.
Planning a new tank. A 55-gallon tank is a blank slate. Check the whole planned stocking in tank mode: the pair table shows which pairs work, the stocking total shows whether the tank is over the inch-per-gallon guide, and the schooling check shows whether every group is big enough. Change the plan until the verdict is Compatible, then buy the fish.
Helping a friend or a child. A child who wants a goldfish and a tropical fish in the same tank needs a clear answer, and the checker gives one: goldfish and neon scores 64, Not compatible, because the goldfish will eat the neon. The steps list shows the arithmetic, so the answer is not just an opinion.
At the fish shop. The checker works on a phone. Before you buy a fish you have not researched, check it against the species you already keep. Two minutes in the shop saves a dead fish at home.
For clubs and classrooms. Aquarium clubs and school science classes can use the checker to teach compatibility: the worked examples show how temperature, pH, temperament, and size combine into a verdict, and the species table is a compact reference for the 24 most common freshwater species.
Sources
Seriously Fish is the governing source for temperature, pH, hardness, adult size, minimum group size, and minimum tank size for 23 of the 24 species in the checker. Seriously Fish species profiles publish all of those figures in one place, with temperament notes that the aggression ratings are drawn from, and the profiles were re-checked against the live site on 20 November 2026. Representative profiles: Neon Tetra, Cardinal Tetra, Betta, Angelfish, Discus, Tiger Barb, Oscar, and Convict Cichlid. Where Seriously Fish and another source disagree on a figure, Seriously Fish governs, and the disagreement is recorded in the tool's documentation.
FishBase is the cross-check for temperature, pH, hardness, and adult size, and the governing source for the goldfish hardness range (5 to 19 dGH) and the goldfish group size (5 or more). FishBase records wild habitat data, so its ranges are sometimes narrower than aquarium care ranges: the harlequin rasbora's FishBase temperature range of 22 to 25 degrees Celsius is a wild habitat range, and the checker uses the wider aquarium care range of 70 to 82 degrees Fahrenheit instead. FishBase species pages were re-checked on 20 November 2026.
LiveAquaria species profiles are a second cross-check for temperature, pH, adult size, and minimum tank size. LiveAquaria's figures are retail care guides, and they sometimes differ from Seriously Fish: LiveAquaria lists the swordtail at about 4 inches maximum, while Seriously Fish lists 140 millimeters standard length, about 5.5 inches. Where the two disagree, Seriously Fish governs, because its figures come from species profiles rather than retail listings.
Aqueon care guides are the governing source for the goldfish, which has no Seriously Fish profile: the temperature range of 60 to 74 degrees Fahrenheit spans Aqueon's figures for comets and fancy goldfish, the pH range of 7.0 to 8.4 is Aqueon's ideal, and the 20-gallon minimum is Aqueon's figure for one adult common or comet goldfish. Aqueon's rule of thumb of one inch of adult fish per net gallon is the basis for the tank-mode stocking check, with the checker's own caveat that the guide is rough and that filtration and water changes matter more than the exact number. The Aqueon goldfish care guide was re-checked on 20 November 2026.
All species data in the checker was last reviewed on 20 November 2026, and the next review is due on 19 May 2027. Species care data changes slowly, but taxonomy moves: if a scientific name in the checker has been superseded, the Seriously Fish name is kept until the next review, and the superseded name is noted in the species section above.
Frequently asked questions
Can neon tetras live with angelfish?
No. An angelfish grows to 6 inches and a neon tetra to 1.2 inches, a size ratio of 5.0, and the angelfish is predatory, so the checker applies the predation gate and the verdict is Not compatible, with a score of 42. The two fish also share only 2 degrees of temperature (75 to 77 degrees Fahrenheit). Angelfish eat small fish such as tetras as they grow, so neons vanish one by one. Keep angelfish with larger, robust tankmates such as bronze corydoras, which score 77, Compatible with care, because the corydoras is armored.
Can bettas live with guppies?
It is risky. The pair scores 77, which is a Compatible with care score, but the verdict drops to Risky because a male betta may treat a guppy as a rival: the guppy's bright colors and flowing tail look like another betta to a territorial male. Some individual bettas ignore guppies, which is why the pair is Risky rather than Not compatible, but the combination fails often enough that the checker downgrades it. Seriously Fish says the betta is best kept alone. If you try the combination, use a large, well-planted tank, add the betta last, and have a spare tank ready.
Can goldfish live with tropical fish?
Mostly no. Goldfish are coldwater fish that need 60 to 74 degrees Fahrenheit, while most tropical fish need 72 degrees or warmer, and goldfish are predatory toward small fish: a goldfish with a neon tetra scores 64 and the predation gate fires, because the goldfish is 6.7 times the size of the neon. Goldfish also produce far more waste than tropical fish. The best goldfish tankmate in the checker is the bristlenose pleco, which scores 89, Compatible, because it is armored and shares the goldfish's cooler water. Keep goldfish with other goldfish, or with armored cool-water species, and never in a heated tropical tank.
How many fish can I keep in a 20-gallon tank?
The rough guide is one inch of adult fish per gallon, so a 20-gallon tank holds about 20 inches of adult fish. The checker adds up the adult size of every fish: 8 neon tetras at 1.2 inches, 6 bronze corydoras at 3.0 inches, and 1 bristlenose pleco at 5.0 inches total 32.6 inches, which is 1.63 inches per gallon in a 20-gallon tank, so the checker calls that stocking over the guide and drops the verdict one band. The guide is rough: heavy-bodied fish such as goldfish need far more water per inch than slim tetras, and filtration and water changes matter more than the exact number. Use tank mode to check your own stocking.
How many of each schooling fish do I need?
The checker uses these minimum groups: neon tetra 8, cardinal tetra 8, zebra danio 8, harlequin rasbora 8, white cloud mountain minnow 10, tiger barb 6, cherry barb 6, black skirt tetra 6, bronze corydoras 6, kuhli loach 6, discus 6, goldfish 5, and clown loach 5. Schooling fish kept below their minimum are stressed, shy, and prone to disease, and some turn aggressive. The white cloud minimum of 10 comes from Seriously Fish, which recommends a group of 10 or more. Buy schooling fish in the full group at once if you can.
Do tiger barbs nip fins?
Yes. Tiger barbs are notorious fin-nippers, and Seriously Fish describes them as notoriously aggressive toward the fins of other fish. The checker treats the tiger barb as a severe fin-nipper: paired with a long-finned species such as a betta, a guppy, an angelfish, or a dwarf gourami, the fin-nipping hard gate fires and the verdict is Not compatible, whatever the score. Tiger barb and betta scores 96 and still fails. With small fish such as neons, the verdict drops one band. Keep tiger barbs in a group of at least 6 with fast, robust, short-finned fish.
Why does the checker say a pair is incompatible when the score is high?
Because hard gates override the score. Four conditions force a Not compatible verdict whatever the points say: temperature ranges that do not overlap, pH ranges that do not overlap, a predatory fish at least three times the size of its tankmate, and a severe fin-nipper paired with a long-finned species. Tiger barb and betta scores 96, the highest score of any incompatible pair, but the fin-nipping gate fires because tiger barbs shred a betta's fins. The result names the gate that fired, so you can see exactly which problem killed the pairing.
Is this checker a substitute for research?
No. The checker is a guideline built from published care ranges, and individual fish vary: a peaceful species can produce an aggressive individual, and a breeding pair of cichlids is far more aggressive than the same fish outside breeding season. Tank layout, hiding places, sex ratios, and feeding all change how fish behave, and the checker does not cover water chemistry beyond temperature, pH, and hardness, or disease. Quarantine new fish for two to four weeks, watch the tank for a week after any introduction, and read the species profiles linked in the sources section before you buy.