Aquarium water parameters, explained properly.
Water parameters are the invisible foundation of every healthy tank. This is the complete guide to what each one means, the ranges that matter, and how to match fish to the water you actually have.
Almost every "mystery" fish death traces back to a water parameter that was wrong in a way the keeper could not see. The water looked clear, the fish looked fine, and then it wasn't. Parameters are the chemistry of the water your fish live in twenty-four hours a day, and getting them right — or at least understanding them — is the single highest-leverage skill in the hobby. This guide explains every parameter that matters, what range to aim for, and how to match a fish to your water instead of fighting your water to suit a fish. When you want to compare ideal ranges across species at a glance, the water parameter reference tool does it instantly.
The Two Groups of Parameters
It helps to split parameters into two categories, because they fail in completely different ways. The first group is water chemistry — temperature, pH, GH, and KH. These describe the kind of water you have and rarely change fast; they decide which species can thrive long-term. The second group is the nitrogen cycle — ammonia, nitrite, and nitrate. These describe how clean the water is right now, change quickly, and kill fast when they go wrong.
A fish in the wrong chemistry declines slowly over months. A fish in an uncycled tank with ammonia can die in days. Both matter, but they are different problems with different solutions, and confusing them is the root of a lot of bad advice.
The core idea: chemistry decides which fish belong in your water. The nitrogen cycle decides whether any fish can survive in it right now. Get the cycle right first, then match species to your chemistry.
Temperature
Temperature is the hardest parameter to compromise on because every fish in a tank shares exactly one temperature. Most tropical community fish want 74–80°F (23–27°C); coldwater fish like goldfish and white clouds want 64–72°F (18–22°C); sensitive warmwater fish like discus want 82–86°F (28–30°C). These ranges do not all overlap, which is why you cannot mix coldwater and tropical fish — there is no shared temperature that keeps both healthy.
Temperature also drives metabolism. Warmer water speeds up a fish's metabolism, appetite, and waste output, and holds less dissolved oxygen. That is why a heat wave can crash a heavily stocked tank: warm water plus high bioload equals an oxygen shortage. Stability matters as much as the number — a steady 77°F beats a tank that swings between 74 and 82°F every day. Use the temperature converter to translate between °F and °C, and the heater size calculator to hold a stable temperature.
pH
pH measures how acidic or alkaline the water is, on a scale of 0–14, where 7 is neutral. Most freshwater fish live somewhere between pH 6.5 and 8.0. Soft-water species — most tetras, rasboras, wild bettas, many catfish — prefer the acidic end (6.0–7.0); hard-water species — livebearers, African cichlids, many shrimp — prefer the alkaline end (7.5–8.5).
The biggest pH mistake is chasing a number. A stable pH that is slightly "wrong" for a species is almost always better than a perfect pH that swings, because rapid pH changes cause far more stress than a steady off-target value. Most fish adapt to a stable pH a little outside their ideal range; few tolerate a pH that bounces. If you do need to adjust pH, the pH buffer calculator doses it safely — but the better long-term move is to keep fish suited to your tap water's natural pH.
GH and KH (Hardness)
Hardness is the most misunderstood pair of parameters, partly because there are two of them and they sound similar. GH (general hardness) measures dissolved minerals — mainly calcium and magnesium — that fish and invertebrates need for healthy biology. Shrimp need adequate GH to molt; livebearers need it to thrive. KH (carbonate hardness) measures buffering capacity: how well the water resists pH changes. KH is the hidden hand behind pH stability — low KH means a tank whose pH swings and crashes, high KH means a rock-steady pH.
The two usually move together (hard water is high in both) but not always, and the distinction matters. A tank with low KH can suffer sudden pH crashes that kill fish overnight, even if GH looks fine. The GH/KH converter translates between dGH, dKH, ppm, and mmol/L and explains the buffering relationship in depth.
Ammonia, Nitrite, and Nitrate
These three are the nitrogen cycle, and the rule is simple: ammonia and nitrite should always read zero; nitrate should stay low. Fish constantly excrete ammonia, which is highly toxic. In a cycled tank, beneficial bacteria convert ammonia to nitrite (also toxic) and then to nitrate (relatively harmless in moderation). A new tank has no bacteria yet, so ammonia accumulates and poisons the fish — this is "new tank syndrome," and it is the most common killer of beginner fish.
Any detectable ammonia or nitrite means a problem: an uncycled tank, an overstocked one, overfeeding, or a filter that was over-cleaned. Nitrate, the end product, is controlled by water changes; most fish are fine below 20–40 ppm, but high nitrate stresses fish and fuels algae. The nitrogen cycle tracker interprets your ammonia and nitrite readings, and the water change calculator tells you how much to change to control nitrate.
Match the Fish to the Water, Not the Water to the Fish
Here is the most useful principle in this entire guide: it is far easier to choose fish that suit your tap water than to constantly chemically adjust your water to suit fish. Test your tap water's pH, GH, and KH once, and treat those numbers as a menu. If you have hard, alkaline water, livebearers, rainbowfish, and many cichlids will thrive with zero intervention. If you have soft, acidic water, tetras and many catfish are happy. Fighting your water with chemicals is a treadmill — every water change resets it, and the swings stress fish more than the original "wrong" number ever would.
The fish compatibility checker reads from the same species parameter data, so you can confirm two species not only get along behaviorally but actually want the same water before you commit. And the broader philosophy — keep fish suited to your conditions — is the foundation of every recommendation in SpawnOS, the aquarium operating system by Blackwater Aquatics Canada.
A Simple Testing Routine
You do not need to test obsessively, but you do need a routine. During a tank's first two months, test ammonia and nitrite every few days until both hold at zero — that confirms the cycle. After that, a weekly nitrate test tells you whether your water-change schedule is keeping up, and a monthly check of pH, GH, and KH catches slow drift. A liquid test kit is far more accurate than test strips, which are notoriously unreliable for the parameters that matter most. Log the numbers; a trend over weeks tells you more than any single reading.
Frequently Asked Questions
What are the ideal water parameters for a community aquarium?
A typical tropical community runs at 75–78°F (24–26°C), pH 6.8–7.6, GH 4–12 dGH, KH 3–8 dKH, with ammonia and nitrite at zero and nitrate under 40 ppm. Specific species shift these targets, which is what the water parameter reference is for.
Should I adjust my tap water's pH for my fish?
Usually no. A stable pH slightly outside a species' ideal range is healthier than a "perfect" pH that swings. Choose fish suited to your tap water instead, and only adjust pH for specialized goals like breeding soft-water species.
Why are my fish dying when all my parameters test fine?
"Fine" for the tank may not be fine for a specific fish at the edge of its tolerance. Chronic stress from mismatched chemistry — especially temperature, pH, or hardness — suppresses the immune system, so fish lose to infections they would otherwise resist. Check that your parameters match each species' range, not just that they fall in a generic band.
What is the most important water parameter?
For a new tank, ammonia — an uncycled tank kills fish fastest. For an established tank, temperature and stability, because those are shared by every fish and cannot be compromised. Both come before pH and hardness, which fish adapt to as long as they are steady.
Related tools
More from the SpawnOS calculator suite.
GH/KH Converter
Convert between dGH, dKH, ppm (mg/L CaCO₃), and mmol/L. Includes carbonate hardness buffering guide and species GH/KH reference table.
🧪pH Buffer
Calculate how much pH buffer (sodium bicarbonate, crushed coral, peat, etc.) to add to raise or lower your tank's pH to a target value.
🤝Compatibility Checker
Evaluate whether two species can safely share a tank. Analyzes water parameter overlap, temperament, size disparity, and dietary compatibility.