Identify ich, fin rot, velvet, columnaris, and more — with symptoms, causes, and step-by-step treatment for each.
Disease & Troubleshooting
Diagnose and fix common aquarium problems — cloudy water, algae outbreaks, fish diseases, and the water quality issues behind them.
Most aquarium problems are water quality problems wearing a costume. Cloudy water, algae outbreaks, sick fish, fish gasping at the surface, fish dying overnight — these are nearly always symptoms, not causes, and the cause is almost always something measurable in the water. The most useful skill in fishkeeping is not memorising medications; it is learning to read the symptoms back to the parameter that caused them. This section walks through the common problems and the root causes that actually fix them.
The single most important troubleshooting step is also the simplest: test your water. Before adding medication, before doing anything drastic, test ammonia, nitrite, nitrate, and pH. A spike in ammonia or nitrite is the cause behind most "mystery" fish deaths, and the fix is a large water change plus a look at whether your filter is undersized, recently washed in tap water, or simply not cycled. Skipping the test and reaching for medication kills fish more often than the original problem does, because medications stress already-stressed fish and can crash your biofilter.
Fish diseases fall into a few broad categories. Parasites (ich, velvet, flukes) cause visible spots, flashing against decor, and rapid breathing. Bacterial infections (fin rot, columnaris, ulcers) cause ragged fins, cottony patches, and lethargy. Fungal infections (white fuzz on wounds, mouth fungus) usually appear secondarily after a parasite or injury. The Common Aquarium Diseases guide covers the major ones with symptoms, causes, and step-by-step treatment. The nano fish diseases guide focuses on small tanks where diseases spread faster and treatment doses must be exact.
Algae is the other category of "problem" that drives beginners mad. The truth is that algae is not a disease — it is a plant, and it grows because conditions favour it. Brown diatom algae in a new tank is normal and disappears on its own within weeks. Green spot algae on the glass means low phosphate or low CO₂. Hair algae means too much light and too many nutrients in the wrong ratio. Black beard algae often means fluctuating CO₂ or organics building up. The algae guide explains each type and the specific fix — none of which involve buying an algae-eating fish, which almost never solves the underlying problem.
Cloudy water has three common causes: bacterial bloom (a sign of an immature or overloaded biofilter), green water (suspended unicellular algae, usually from excess light plus nutrients), and particulate cloud (insufficient mechanical filtration or disturbed substrate). Each has a different fix — bacterial blooms resolve with patience and reduced feeding, green water responds to blackouts and UV, and particulate clears with better filter floss. Treating the wrong cause wastes time and stresses the tank.
The experience guides in this section — Why Guppies Are Dying and The Truth About Endlers — are honest field reports from our own fishroom. They cover what actually happened when a species did not thrive, what we changed, and what we learned. More specific disease and troubleshooting pages are in progress (Cloudy Water, Green Water, Brown Algae, Hair Algae, Fish Gasping, Fish Dying Suddenly, Ich, Fin Rot, White Fungus) and will appear as coming-soon cards below.
A diagnostic order of operations
When something is wrong in your tank, work through checks in this order: parameters, behaviour, equipment, then disease. Test ammonia and nitrite first — if either reads above zero, that is almost certainly your problem and you need a large water change immediately, not medication. Next, observe fish behaviour for an hour: gasping at the surface means oxygen or ammonia, clamping fins means stress or parasites, flashing against decor means skin irritation or ich, hiding unusually means a bully or poor water.
After behaviour, check equipment. Is the filter running and not clogged? Is the heater holding temperature (verify with a separate thermometer, not the heater’s built-in dial)? Is the temperature within the species’s preferred range? Equipment failures cause a surprising number of "disease" outbreaks — a failed heater chilling a tank by eight degrees overnight will look exactly like a parasitic infection in the morning. A clogged filter that has stopped cycling water through its media will cause an ammonia spike that looks like fish illness.
Only after parameters, behaviour, and equipment are all ruled out should you reach for disease treatment. When you do, treat in a quarantine tank whenever possible — many medications crash biofilters, stain silicone, harm invertebrates, or kill plants. Copper-based treatments kill shrimp and snails outright. Malachite green (the active ingredient in many ich treatments) stains everything it touches. Quarantine tanks let you dose accurately, observe the sick fish in isolation, and protect the rest of your tank from collateral damage.
A final principle that took us years to internalise: euthanising a fish is sometimes the right answer. A fish that has stopped eating, lost buoyancy control, and shows no response to treatment over several days is suffering. A clove-oil overdose is the humane method. Holding out for a miracle recovery that will not come is not kindness; it is prolonging distress. Every experienced aquarist has made this call, and learning when to make it is part of responsible fishkeeping.
Essential troubleshooting guides 5 articles
Small tanks spread disease fast — symptoms, dosing, and quarantine strategies specific to nano fish and small volumes.
Every common algae type in small tanks — what each one tells you about your water, and the specific fix that actually works.
An honest post-mortem on guppy deaths in our fishroom — the parameters, the stressors, and what we changed to stop the losses.
Tiny, shimmering and adorable — but mean in their own way. What really happened with our Japan Blue trio and cherry shrimp.
Symptom-specific guides in progress coming soon
Bacterial bloom, particulate, or green water? Identify which type you have and the specific fix for each.
Suspended algae that turns your tank into pea soup — the three-day blackout, UV sterilisers, and why water changes alone fail.
The brown dust that covers everything in new tanks — why it appears, why it leaves on its own, and when to worry.
Long, stringy, and fast-growing — the nutrient imbalance that causes it and the lighting and dosing changes that end it.
Low oxygen, high ammonia, or gill damage? How to tell which it is and what to do in the first hour to save the fish.
No visible symptoms and a dead fish — ammonia, nitrite, temperature swing, or toxicity. The diagnostic checklist that finds the cause.
The most common aquarium parasite — the lifecycle that makes it curable, heat and salt protocols, and why you must treat the whole tank.
Ragged, receding fins that trace back to poor water — the parameter fixes that cure mild cases without antibiotics.
Cottony growths that usually follow an injury or parasite — identifying true fungus, treating it, and fixing the underlying wound.
Continue learning other categories
Avoid most of the problems in this section by starting right — cycling, tank size, stocking, and the predictable mistakes.
pH, ammonia, nitrite, nitrate, GH, KH — the parameters behind almost every problem you will troubleshoot here.
A failed heater or washed filter is often the real culprit behind disease — filters, heaters, lights, test kits explained.