Fish Compatibility Calculator – Freshwater Aquarium Tank Mates

Fish Compatibility Calculator

Before you add a new fish to your aquarium, find out if they will get along. Select two freshwater species to instantly see how they match based on temperament, size, water parameters, and social behavior. Create a peaceful community tank with confidence.

🔍 Check Fish Compatibility

What Is a Fish Compatibility Calculator?

A fish compatibility calculator helps aquarium hobbyists determine whether different species can peacefully coexist in the same tank. It considers several critical factors: temperament (aggressive vs. peaceful), adult size, water parameter requirements (pH, temperature, hardness), social behavior (schooling, territorial, or solitary), and swimming zone preferences. A community tank with incompatible fish will lead to chronic stress, injuries, disease outbreaks, and even death. This tool gives you a science‑based, hobbyist‑proven compatibility score to avoid heartbreaking mistakes.

While no calculator can guarantee success, our system aggregates knowledge from decades of community aquarium experience, including data from trusted sources such as FishBase, LiveAquaria, SeriouslyFish, and the American Cichlid Association to provide reliable guidance.

Why Fish Compatibility Matters – For Health and Harmony

Preventing Aggression & Injury

Incompatible fish lead to fin nipping, chasing, and outright attacks. Stressed fish have weakened immune systems and are more susceptible to diseases like ich and fin rot. Tiger barbs, for example, are known fin nippers that can devastate slow‑moving or long‑finned tankmates.

Matching Water Parameters

Species from different continents often require different pH, hardness, and temperature. Keeping soft‑water Amazon species with hard‑water African cichlids causes chronic stress and premature death. A compatibility check ensures your entire community shares the same optimal conditions.

Avoiding Inadvertent Predation

Many aquarium fish are opportunistic predators. Angelfish will eat small neons, and large cichlids will consume any fish that fits in their mouth. Size mismatch is a leading cause of disappearing fish in community tanks.

Reduced Maintenance & Health Costs

Peaceful, compatible communities suffer fewer disease outbreaks, require fewer medications, and need less frequent water changes due to reduced stress‑induced waste output. A balanced community is easier and cheaper to maintain.

Key Factors That Determine Fish Compatibility

  • Temperament: Fish are broadly classified as peaceful, semi‑aggressive, or aggressive. Peaceful tetras should never be housed with aggressive cichlids. Semi‑aggressive species like angelfish may work in a community if tank space and hiding spots are adequate.
  • Adult Size & Growth Rate: A 1‑inch juvenile might be peaceful, but as an adult it could become a predator. Always research maximum size. The size difference between two fish should never exceed 2‑3 inches, and the smaller species must not be small enough to be eaten.
  • Water Parameter Requirements: Temperature, pH, GH (general hardness), and KH (carbonate hardness) must overlap significantly. For example, discus require warm, soft, acidic water (82‑86°F, pH 5.5‑6.5), while goldfish prefer cool, hard, alkaline conditions (65‑72°F, pH 7.0‑8.0). They can never be compatible.
  • Swimming Zone & Activity Level: Fish occupy top, middle, bottom, or all zones. Overcrowding one zone causes aggression. Highly active danios can stress slow‑moving gouramis even if both are peaceful.
  • Social Structure: Schooling fish (neon tetras, corydoras) need groups of at least 6 to feel secure. Territorial species (many cichlids) require space and visual barriers. Solitary bettas often fight with conspecifics and similarly flashy fish.
  • Dietary Needs: Carnivores, herbivores, and omnivores differ in feeding behavior. A predator fish housed with small herbivores will see them as food, not tankmates.

Our calculator evaluates each of these factors and provides a compatibility score based on a proprietary algorithm that aggregates data from authoritative sources, including FishBase, the American Cichlid Association, SeriouslyFish, and LiveAquaria profiles.

How to Interpret the Compatibility Score

✓ Excellent Match

These species are highly compatible. Temperaments align, water parameters match, and size differences are safe. This is a tried‑and‑true community combination recommended by experienced aquarists.

⚠️ Good with Monitoring

Typically compatible but may have minor conflicts. Provide adequate space, hiding spots, and monitor during feeding. Works well in larger, well‑planted tanks.

❗ Caution Advised

Significant risks. Only attempt in large, specialized setups with experienced keepers. High chance of aggression, stress, or predation.

✗ Not Recommended

Serious incompatibility. Do not house together. Water parameters, temperament, or size mismatch will lead to injury, stress, or death.

Popular Community Tank Combinations That Work

🐟 Beginner Community (20+ gallons): Neon Tetras, Corydoras Catfish, Harlequin Rasboras, and a Honey Gourami. All peaceful, occupy different zones, and share similar water parameters (72‑78°F, pH 6.5‑7.5).
Compatibility: Excellent

🌿 Planted Tank (30+ gallons): Angelfish (single or pair), Rummy Nose Tetras, Otocinclus Catfish, and Amano Shrimp. Angelfish are semi‑aggressive but work with fast schooling tetras when tank is spacious and planted.
Compatibility: Good with Monitoring

🐠 Livebearer Community (20+ gallons): Guppies, Platys, Mollies, and Swordtails. All peaceful, share similar hard water preferences (pH 7.0‑8.0), and are prolific breeders.
Compatibility: Excellent

🪨 African Cichlid Tank (55+ gallons): Mix of Mbuna cichlids (e.g., Yellow Labs, Zebra Cichlids) with similar aggression levels. Never mix with peaceful tetras or soft‑water species.
Compatibility: Excellent for conspecifics; Poor with other families

Common Incompatible Combinations to Avoid

  • Betta with Male Guppies or Other Bettas: Male bettas are aggressive to any fish with long, flowing fins that resemble rival bettas — guppies, endlers, and even fancy goldfish are at high risk. Never keep two male bettas together.
  • Angelfish with Neon Tetras: Adult angelfish instinctively prey on small tetras. Neons are a natural food source in the wild. Always keep angelfish with larger tetras (e.g., Black Skirt, Buenos Aires) or fast schooling fish.
  • Tiger Barbs with Long‑Finned Fish: Tiger barbs are notorious fin nippers. They will shred the fins of angelfish, bettas, gouramis, and fancy guppies. Keep tiger barbs only with other fast, short‑finned species in large groups of 8+ to minimize aggression.
  • Goldfish with Tropical Fish: Goldfish require cold water (65‑72°F), while most tropicals need 75‑82°F. This temperature gap is lethal to one of them. Also, goldfish produce heavy waste, raising ammonia levels that stress tropicals.
  • African Cichlids with South American Cichlids (or Tetras): African rift lake cichlids require hard, alkaline water (pH 7.8‑8.6), while Amazonian species need soft, acidic water (pH 6.0‑7.0). They cannot share the same environment safely.
  • Oscars with Small Community Fish: Oscars grow to 12‑14 inches and are opportunistic predators. Any fish that fits in their mouth becomes food — including tetras, guppies, and small catfish.

How to Use the Compatibility Calculator Effectively

  1. Build your potential community list: Research species that appeal to you. Note their adult size, temperament, and water requirements.
  2. Use the calculator as a first pass: Enter species pairs to quickly rule out obvious incompatibilities (e.g., temperature, pH, size mismatch).
  3. Check swimming zones: Ensure you have top, middle, and bottom‑dwelling fish to reduce competition for space. The calculator highlights this.
  4. Read the detailed considerations: Our result panel provides specific warnings and tips, such as “Neon tetras should be kept in schools of 6+.”
  5. Combine with other tools: After confirming compatibility, use our Fish Tank Stocking Calculator to ensure your tank isn't overcrowded.
  6. Always have a backup plan: Even compatible fish can occasionally conflict. Prepare a quarantine tank or plan for rehoming if aggression appears after introduction.

Special Cases: Betta, Goldfish & Cichlids

  • Betta (Siamese Fighting Fish): Male bettas can sometimes be kept in community tanks with peaceful, non‑nippy fish like harlequin rasboras, corydoras catfish, and neon tetras. Avoid fin‑nippers and other labyrinth fish. Female bettas can be kept together in sororities of 5+ with ample space.
  • Goldfish: Goldfish are best kept with other goldfish or hardy cold‑water fish like white cloud mountain minnows and dojo loaches. Never mix fancy goldfish with common goldfish (different swimming speeds). Avoid tropicals — the temperature requirements conflict.
  • Cichlids (African & South American): African cichlids from Lake Malawi and Lake Tanganyika require hard, alkaline water and are aggressive. Overstocking and rocky d scaping reduce aggression. South American cichlids (angelfish, discus, rams) need soft, acidic water and more peaceful tankmates. Never mix these two groups.

Frequently Asked Questions

1. Can I mix different types of tetras together?
Yes, most tetras are peaceful and can be mixed, but always keep each species in a school of at least 6. For example, neon tetras and cardinal tetras share similar water requirements and temperament — they are excellent tankmates. However, avoid mixing very small tetras (like ember tetras) with significantly larger, more active species that could outcompete them for food.
2. Will angelfish eat my neon tetras?
Adult angelfish (3‑4+ inches) are natural predators of small tetras. While they can coexist when both are juveniles, once angelfish reach 3 inches, neon tetras become a target. Keep angelfish with larger tetras such as black skirt tetras, congo tetras, or bleeding heart tetras for a safer community.
3. Can betta fish live with other fish in a community tank?
Yes, but only with careful selection. Male bettas can be kept with peaceful, non‑nippy species that don't have long, flowing fins. Good tankmates include harlequin rasboras, ember tetras, corydoras catfish, and kuhli loaches. Avoid guppies, other bettas, tiger barbs, and aggressive cichlids. Always provide plenty of plants and hiding spots and a tank of at least 10‑15 gallons.
4. Is this calculator accurate for both freshwater and saltwater fish?
Our current version is optimized for freshwater tropical species. The principles are the same for saltwater, but marine fish have unique compatibility rules (e.g., tangs vs. other tangs, angelfish territoriality). We recommend checking marine‑specific resources like LiveAquaria's compatibility chart for reef tanks.
5. What is the best number of fish for a community tank?
Beyond compatibility, safe stocking depends on tank size, filtration, and species bioload. Use our Fish Tank Stocking Calculator to find the ideal number after you’ve determined compatible species. A good guideline is 1 inch of adult fish per gallon for small, peaceful species, but this varies significantly with fish shape and waste production.
6. How do I introduce new fish to an established community?
Always quarantine new fish for 2‑4 weeks to prevent disease introduction. Then, rearrange the tank d cor before adding to break established territories. Add the new fish after lights out to reduce aggression. Monitor for the first 24 hours; keep the lights dim to reduce stress. Have a backup plan if severe aggression occurs.
7. Can I keep shrimp or snails with my fish?
Many community fish eat shrimp. Small, peaceful species (neon tetras, otocinclus) are safe with larger shrimp like Amano or Cherry Shrimp. Avoid keeping shrimp with cichlids, large gouramis, or goldfish. Snails (nerite, mystery) are usually safe with most community fish, but loaches and puffers will eat them.
8. What if my fish are already fighting — what should I do?
Immediately separate aggressive fish using a tank divider or move one to a quarantine tank. Add more hiding spots (plants, caves, d cor) and rearrange the layout to disrupt territories. If aggression persists, the incompatible pair must be permanently separated — either rehome one or set up a new tank.

📚 Related Calculators for a Successful Community Tank

Build a Peaceful Community, Starting Here

Creating a harmonious aquarium is both an art and a science. Use our Compatibility Calculator as your first filter, then research each species in depth. Combine compatibility checking with proper stocking, filtration, water volume planning, and regular maintenance for a thriving tank. Bookmark this page and explore our suite of calculators to master every aspect of fishkeeping.