Aquarium problems and fixes feel much less stressful when you know what to check first.
This hub brings together PetYeti’s beginner-friendly troubleshooting guides for cloudy water, green water, algae, fish behavior, shrimp hiding, heater issues, filter noise, plant problems, smells, foam, yellow water, and other common aquarium problems.
If something looks wrong in your tank, start calmly. Check the water, observe your fish, look for recent changes, and avoid sudden full-tank resets unless there is an emergency. Most beginner aquarium problems are easier to solve when we slow down and find the cause first.
Curated by PetYeti Aquariums for calm, beginner-friendly aquarium troubleshooting at home.
Start Here If Something Looks Wrong
If something looks wrong in your aquarium, start with the most visible clues: water clarity, fish behavior, surface breathing, smells, equipment issues, and recent changes. Most beginner aquarium problems are easier to fix when we check calmly instead of rushing into a full tank reset.
How to Test Aquarium Water Correctly (Beginner Guide)
Start here if you want to check the water before guessing.
Why Your Betta Fish Tank Looks Cloudy (And How to Fix It)
Use this if the water looks hazy, milky, or unclear.
Why Do My Fish Stay at the Surface? Common Causes and Easy Fixes
Helpful if fish are hanging near the top or breathing at the surface.
Why Are My Fish Breathing Fast? Common Causes and Easy Fixes
Use this if fish look stressed, active, or are breathing faster than normal.
Why Is My Aquarium Filter So Loud? 9 Easy Fixes
Helpful if the problem seems connected to filter noise, rattling, buzzing, or splashing.
Understand Fish Behavior Clues
Fish behavior is often the first sign that something has changed in the aquarium. Hiding, not eating, fast breathing, flashing, color loss, or unusual swimming can point to stress, water-quality problems, illness, bullying, or recent changes in the tank.
Why Is My Fish Hiding? Common Causes and Easy Fixes
Use this if a fish suddenly spends more time behind plants, decorations, or filter areas.
Why Is My Fish Not Eating? Common Causes and Easy Fixes
Helpful if a fish refuses food, spits food out, or has a sudden appetite change.
Why Are My Fish Losing Color? Common Causes and Easy Fixes
Use this if fish look pale, dull, washed out, or less colorful than normal.
Why Is My Fish Swimming Erratically? Common Causes and Easy Fixes
Helpful if a fish is darting, spinning, swimming oddly, or acting restless.
Why Are My Fish Flashing Against Decorations? Easy Fixes
Use this if fish are rubbing against gravel, plants, rocks, or decorations.
Fix Water Clarity and Surface Problems
Water problems can look scary at first, but they usually point to something specific: a new tank, excess nutrients, uneaten food, surface buildup, poor maintenance rhythm, or unstable water quality. Check the cause before doing a full cleanout.
Why Your Betta Fish Tank Looks Cloudy (And How to Fix It)
Use this if the water looks milky, hazy, or unclear.
Why Is My Aquarium Water Green? Causes and Easy Solutions
Helpful if the water has a green tint or looks like pea soup.
Why Is My Aquarium Water Foamy? Common Causes & Easy Fixes
Use this if foam or bubbles collect on the surface.
Why Is My Aquarium Water Turning Yellow? Easy Fixes
Helpful if the water looks tea-colored, yellow, or stained.
Why Does My Aquarium Water Smell? Easy Fixes
Use this if the tank has an unpleasant odor and you need to find the cause.
Troubleshoot Betta, Shrimp, and Tank Stress
Some aquarium problems show up through specific fish or shrimp behavior. Bettas may rest at the bottom, glass surf, or act weak when something feels off, while shrimp may hide more when they are stressed, newly added, molting, or uncomfortable in the tank.
Why Is My Betta Staying at the Bottom?
Use this if your betta is resting low, acting tired, or spending too much time near the substrate.
Why Is My Betta Laying on Its Side?
Helpful if your betta looks weak, unbalanced, or is resting in a way that worries you.
Why Is My Betta Glass Surfing? Easy Fixes
Use this if your betta keeps swimming up and down the glass.
Why Are My Shrimp Hiding? Common Causes and Easy Fixes
Helpful if shrimp disappear into plants, caves, moss, or decorations more than usual.
Why Are My Fish Chasing Each Other?
Use this if the problem looks like bullying, mating behavior, territorial behavior, or stocking stress.
Check Equipment and Tank Conditions
Some aquarium problems come from equipment, temperature, water movement, evaporation, or changes around the tank. Before making big changes, check whether the filter, heater, water level, and flow pattern are affecting the way the aquarium behaves.
Why Is My Aquarium Heater Not Working? Causes and Fixes
Use this if the tank temperature is unstable or the heater does not seem to be warming the water.
Why Is My Aquarium Filter So Loud? 9 Easy Fixes
Helpful if the filter is rattling, buzzing, splashing, vibrating, or making the room feel less calm.
Why Are My Fish Staying Near the Filter? Easy Fixes
Use this if fish keep gathering near the filter, outlet, sponge, bubbles, or water flow.
Why Is My Aquarium Losing Water So Fast? Causes & Fixes
Helpful if the water level seems to drop faster than expected.
Why Is My Aquarium Water Evaporating Quickly? Causes Explained
Use this if evaporation keeps happening and you want to understand what may be causing it.
Fix Plant and Algae Problems
Plant and algae problems often come from light, nutrients, water quality, plant choice, or an aquarium that is still finding its balance. Instead of removing all the plants or scrubbing everything at once, check what the leaves, algae growth, and tank routine are telling you.
Why Is Algae Growing So Fast in My Aquarium?
Use this if algae keeps spreading quickly on glass, decorations, plants, or substrate.
How to Control Algae in Betta Tank Naturally
Helpful if you want a gentle algae-control routine for a betta aquarium.
Why Are My Aquarium Plants Turning Brown? 7 Common Causes and Easy Fixes
Use this if plant leaves look brown, damaged, melting, or covered in dull patches.
Why Are My Aquarium Plants Turning Yellow? Easy Fixes
Helpful if leaves are fading, yellowing, or showing signs of lighting or nutrient problems.
Why Are My Aquarium Plants Not Growing? Easy Fixes
Use this if plants look alive but are not producing healthy new growth.
Where to Go Next
Once you identify the problem, the next step is keeping the aquarium more stable so the same issue is less likely to return. These PetYeti hubs can help you connect troubleshooting with water quality, cleaning, gear, plants, and betta tank setup.
Water Quality & Cycling
Use this if the problem seems connected to cloudy water, green water, surface breathing, smells, foam, or unstable tank conditions.
Aquarium Cleaning & Maintenance
Helpful if the tank keeps getting dirty, algae returns quickly, or water problems keep coming back after cleaning.
Aquarium Gear Guides
Use this if the issue may involve filters, heaters, test kits, air pumps, air stones, gravel vacuums, or other beginner equipment.
Betta Tank Setup
Helpful if your betta is glass surfing, staying at the bottom, resting strangely, or acting stressed in the aquarium.
Aquarium Plant Care
Use this if plant problems, algae, yellow leaves, brown leaves, or poor plant growth are part of the issue.
Start With the Basics
Most aquarium problems are easier to solve when you check water quality, avoid overfeeding, keep stocking realistic, and make changes slowly.
A calm aquarium is not a perfect aquarium. It is a stable one.
