Building a peaceful community aquarium is one of the most rewarding challenges in the fishkeeping hobby — and one of the most common sources of heartbreak when it goes wrong. A fish lost to an incompatible tank mate, a beautiful specimen destroyed by fin-nipping, or an entire school wiped out by a water chemistry mismatch are all preventable with the right information before you buy. This calculator exists to give you that information.
Who Should Use This Calculator?
This tool is for any freshwater aquarium hobbyist planning a new community tank, adding new fish to an established setup, or troubleshooting aggression and stress in an existing aquarium. Beginners will use it to build their first safe community stocking list. Intermediate hobbyists will use it to verify that a new species they spotted at the fish store is actually compatible with what they already have at home. Advanced keepers managing species-specific biotope tanks or cichlid communities will use it to cross-reference water chemistry parameters with precision.
It is equally useful for fishkeepers researching a purchase online at midnight as it is for someone standing in a fish store trying to decide in the moment.
The Five Pillars of Compatibility
Successful cohabitation depends on all five of the following parameters aligning — not just one or two. A fish pair that matches on temperament but clashes on water chemistry will still fail.
1. Water Temperature: The acceptable temperature ranges of two species must overlap by at least 4°F (2°C) to form a viable long-term pairing. Keeping fish outside their preferred range causes chronic immune suppression, making them permanently susceptible to disease even if they are not visibly sick.
2. Water pH: pH ranges must overlap by at least 0.5 units. A mismatch causes physiological stress at the cellular level — affecting osmoregulation, enzyme function, and gill health — often before any visible symptoms appear. Chronic pH mismatch shortens fish lifespans significantly.
3. Temperament: Mixing hyper-aggressive or territorial fish with passive, slow-moving species almost always results in injury, chronic stress, or death. Temperament categories — peaceful, semi-aggressive, and aggressive — are starting points, not guarantees. Individual fish personalities vary, and a fish labelled peaceful in one setup may become a bully in an overcrowded or understimulated tank.
4. Adult Size: The golden rule of fishkeeping: if a fish can fit another into its mouth, it eventually will — even if both fish have lived peacefully together for months. Always research the adult size of every species, not the juvenile size you see in the store. A 1-inch juvenile Angelfish will reach 6 inches within a year.
5. Swimming Layer: Fish naturally occupy one of three vertical zones in the water column: surface, mid-water, or bottom. Concentrating too many species in a single zone creates competition for food, space, and resting areas, driving aggression even between otherwise peaceful species.
Zoning Your Aquarium
To minimise territorial disputes and feeding competition, stock fish that inhabit different vertical zones. Combining surface-dwellers (such as hatchetfish or African butterflyfish), mid-water schoolers (such as tetras and rasboras), and bottom-feeders (such as corydoras catfish and kuhli loaches) creates a balanced, dynamic display while keeping stress levels low. A useful target ratio for a community tank is approximately 30% surface species, 50% mid-water species, and 20% bottom-dwelling species by fish count.
When to Use This Calculator
Use it before purchasing any new fish — ideally while still at home with time to research, not standing in the fish store. Use it when planning a new tank stocking list from scratch to verify all species are compatible before buying any of them. Use it when you notice unexplained aggression, hiding, fin damage, or stress in an existing tank, as an incompatibility you missed may be the root cause. Use it to educate yourself on species before gifting fish or recommending them to other hobbyists.
Common Problems This Calculator Prevents
The most frequent compatibility mistakes in freshwater fishkeeping are: mixing Goldfish with tropical species (temperature and waste incompatibility), housing Neon Tetras with adult Angelfish (size predation), combining African and South American cichlids (water chemistry conflict), adding Tiger Barbs to a tank with Bettas or Guppies (fin-nipping aggression), and mixing multiple bottom-feeding species without adequate space and food distribution. Each of these mistakes is entirely avoidable with a compatibility check before purchase.
A Note on Quarantine
No compatibility check replaces a proper quarantine protocol. Always isolate new fish in a separate quarantine tank for a minimum of two weeks before introducing them to your main display. This prevents the introduction of parasites, bacterial infections, and viral diseases that can devastate an established community regardless of species compatibility. Observe initial interactions carefully for the first 72 hours after introduction, and always have a backup plan — a spare tank or a trusted local fish store willing to take back an aggressor — before adding any new species.