Troubleshooting & Reference

Troubleshooting and reference hub

Find the next right check when your tank looks wrong, smells wrong, or starts behaving in a way that does not make sense.

This page is designed to help beginners narrow the likely cause first. Start with the basic signals, then move into the symptom group that best matches what you are seeing in the tank.

Check these first

  • Is the tank still new and mid-cycle?
  • Have you tested the water yet?
  • Does the fish suit the tank size and flow?
  • Did anything change in feeding, lighting, or maintenance this week?

Most beginner tank problems become easier to solve once those four checks are clear.

dirty aquarium glass and algae buildup

Start here

Work through the obvious signals before you assume the tank needs a new product.

Step 1

Confirm the cycle status

If ammonia, nitrite, cloudy water, or a new setup is part of the story, start with cycling before you change gear.

Read How to Cycle a Fish Tank

Step 2

Check the setup basics

Use the checklist when the tank is new or unstable and you need to verify heater, filter, substrate, and maintenance basics.

Open the beginner setup checklist

Step 3

Pressure-test the equipment path

If the tank choice itself might be driving the problem, compare the beginner starter-kit path before buying another random fix.

Read the starter kit guide

Match the symptom

Choose the problem area that sounds most like what the tank is telling you.

Water quality and cycling

  • Cloudy water after setup
  • Ammonia, nitrite, and nitrate confusion
  • Water-change timing questions

Species behavior and compatibility

  • Fish hiding, stressing, or acting unlike normal
  • Tank-mate and stocking questions
  • Care checks for common freshwater species

Filter and tank-size mismatch

  • Flow is too strong for the fish
  • Waste load is outrunning the filter
  • The tank footprint may be too small for the stocking plan

Plants, algae, and maintenance

  • Green buildup, dirty glass, or recurring algae
  • Lighting duration or feeding volume concerns
  • Routine maintenance checks before deeper intervention
freshwater aquarium cycle and water quality

Before you buy another fix

Confirm the root cause first, then decide whether the tank actually needs new gear.

  • Test the water before assuming the filter failed.
  • Check whether the tank is still new and naturally unstable.
  • Match the fish to the actual tank size and current flow.
  • Review light duration, feeding volume, and maintenance timing.

The goal is to help beginners diagnose the real cause first so they stop stacking purchases that do not solve the underlying issue.

Browse the main systems when the problem is bigger than one symptom.