OBSERVE
Describe what changed without deciding why: water appearance, fish behavior, equipment, or another visible difference.
FRESHWATER AQUARIUM TROUBLESHOOTING
What's Wrong With My Aquarium?
A Beginner's Troubleshooting Guide to Cloudy Water, Algae, Fish Stress, Cycling Problems, Filters and Water Quality
By Miles Northcott · Published by Mercer Lane Press
A beginner-focused freshwater aquarium troubleshooting guide built around an observe, test, triage, correct, and verify method. It helps owners investigate cloudy or green water, fish stress, cycling and water-quality problems, filter and temperature failures, water-change problems, recurring algae, feeding and stocking pressure, and decide when specialist or aquatic-veterinary help is appropriate.
WHO IT IS FOR
For the moment when you already have an aquarium and something no longer looks right
Beginner freshwater aquarium owners who already have a tank and need a practical way to work out what changed, what to check first, which measurements matter, how urgent the problem may be, and whether to correct, observe, or escalate.
- Cloudy, green, yellow, or brown water where appearance alone does not identify the cause
- Several fish gasping, hiding, refusing food, flashing, or otherwise behaving differently
- New-tank cycling problems or detectable ammonia and nitrite after stocking or filter disruption
- Filter flow, heater, circulation, or water-change problems that create a clear before-and-after change
- Recurring algae, drifting test results, or instability after cleaning and maintenance
- Uncertainty about when a problem can be investigated at home and when persistent distress, deaths, contamination, or physical abnormalities need specialist help
THE TROUBLESHOOTING METHOD
OBSERVE → TEST → TRIAGE → CORRECT → VERIFY
The book is designed to prevent the common beginner mistake of changing several things before establishing what actually changed and what evidence supports the next step.
TEST
Measure what can reduce uncertainty, especially actual temperature, ammonia, nitrite, and other parameters relevant to the aquarium.
TRIAGE
Decide whether the issue is cosmetic, important, or potentially urgent before choosing a response.
CORRECT
Take the smallest justified action that addresses the evidence instead of changing several variables at once.
VERIFY
Check whether the fish, water, equipment, or measurement actually improved after the intervention.
THE CORE FIVE
Five checks before you reach for a treatment or start rebuilding the tank
1. Fish
Ask whether one fish is affected or several. Compare breathing, swimming, balance, position in the tank, appetite, and responsiveness.
2. Temperature
Use an actual thermometer. A heater setting is not proof of the water temperature.
3. Filter & circulation
Check normal flow, surface movement, intakes, pumps, outages, and whether recent filter work changed the system.
4. Ammonia & nitrite
Use the test results as evidence. An occupied aquarium with detectable ammonia or nitrite deserves investigation in context.
5. Recent change
Reconstruct the last 48 hours and then the last seven days: water changes, filter cleaning, new fish, feeding, products, lighting, substrate disturbance, power loss, or source-water changes.
SYMPTOM-FIRST CHAPTERS
Start where the problem is visible
The book is intentionally non-linear. Readers can begin with the symptom finder, then move to the relevant chapter and back to the Core Five Checks.
The water looks wrong
White or cloudy water, green water, yellow or tea-colored water, surface film, foam, unusual smell, and floating debris.
The fish behave differently
Surface gasping, hiding, unusual inactivity, appetite loss, flashing, clamped fins, physical warning signs, and an unexplained death.
The system changed
Reduced or stopped filter flow, temperature errors, problems after a water change, and problems after adding fish.
The problem keeps returning
Recurring algae, moving water-test results, instability after cleaning, and the combined pressure of feeding and stocking.
The owner keeps intervening
Learn when a controlled observation period is safer and more informative than adding another unrelated change.
The next step is professional
Recognize continuing deaths, severe breathing problems, significant physical abnormalities, suspected toxic exposure, and other situations that exceed home troubleshooting.
BUILD A TANK THAT IS EASIER TO DIAGNOSE
Use a ten-minute weekly check and a useful tank record
Know the baseline
Learn normal fish behavior, usual temperature, filter flow, water-test pattern, and the tank's response to ordinary maintenance.
Record meaningful changes
Keep tank profile, source water, livestock, maintenance, and water-test records simple enough that they still help when a problem appears.
Record the reason for an action
“Added clarifier” is less useful than recording what you saw, what the tests showed, why the action made sense, and what happened afterward.
FREE SUPPORTING GUIDES
Five focused starting points for common aquarium problems
AQUARIUM TROUBLESHOOTING
Cloudy Aquarium Water: What to Check Before You Try to Fix It
Cloudy water describes an appearance, not a cause. Use tank age, visible particles, water tests, filter history, feeding, and recent maintenance to decide what the haze is telling you.
Read the guideAQUARIUM TROUBLESHOOTING
Fish Gasping at the Surface: The First Aquarium Checks to Make
Several fish persistently gathering at the surface deserves prompt attention. Check whether the behavior is abnormal, then work through temperature, circulation, ammonia, nitrite, and recent changes.
Read the guideAQUARIUM TROUBLESHOOTING
New Tank Cycling, Ammonia and Nitrite: A Beginner Troubleshooting Path
A cycling problem is a mismatch between the waste entering the aquarium and the biological filtration currently able to process it. Use measurements and recent history rather than tank age alone.
Read the guideAQUARIUM TROUBLESHOOTING
Aquarium Filter Cleaning Without Destabilizing the Tank
A filter is not merely a dirt trap. Separate mechanical, biological, and chemical functions so maintenance restores flow without automatically discarding established biological filtration.
Read the guideAQUARIUM TROUBLESHOOTING
Aquarium Algae Keeps Coming Back: A Four-Week Troubleshooting Method
Recurring algae is more useful as a pattern than as a one-off nuisance. Track what happens before growth accelerates, then correct the strongest evidence-supported cause instead of repeatedly treating the visible result.
Read the guideIMPORTANT LIMITS
A troubleshooting guide, not a veterinary diagnosis
The book provides general educational and informational guidance. Aquarium conditions and fish requirements vary by species, water source, system design, and individual circumstances. It does not diagnose disease from a single behavior or photograph and it does not replace examination, diagnosis, or treatment by a qualified aquatic veterinarian.
Seek appropriate specialist or veterinary assistance when fish are severely distressed, deteriorating rapidly, experiencing repeated unexplained deaths, showing significant physical abnormalities, or when serious contamination or an equipment hazard is suspected.
SEARCH BY THE PROBLEM
Freshwater aquarium troubleshooting for the problems beginners actually see
Cloudy aquarium water, fish gasping at the surface, ammonia or nitrite during cycling, algae and filter problems are common symptom-led searches. This guide helps owners check the tank in a useful order and avoid treating appearance alone as a diagnosis.
Questions this guide is designed to help with
- Why is my aquarium water cloudy?
- Why are my fish gasping at the surface?
- How do I know if my aquarium cycling problem is ammonia or nitrite?