Troubleshoot
Fish Gasping in a CO₂ Planted Tank
Fish piping at the surface in a high-tech tank is often too much CO₂ or too little O₂—not automatically disease. Kill the gas, add air, then read the drop checker. Still test ammonia so you don’t miss a chemistry emergency.

- Gasping
- CO₂ overdose
- Drop checker
- O₂ crash
What you’re seeing
All fish at the film, rapid gill movement, shrimp climbing out. Worse after lights-on CO₂ ramp or overnight with sealed lids.
| Pattern | Likely driver |
|---|---|
| Drop checker yellow/lime, fish piping | CO₂ overdose |
| Gasping only lights-off | O₂ crash / CO₂ left on |
| Gasping + NH₃ > 0 | Ammonia first |
| White salt spots too | Also check ich |
Likely causes (ranked)
Injected CO₂ too high
Blood CO₂ rises; fish surface for O₂-rich film.
Quick test: Checker lime/yellow; bubble count jumped.
CO₂ left on after lights-out
Plants stop consuming; gas accumulates.
Quick test: Solenoid schedule wrong—see <a href="https://aquaplantshub.com/planted-tank-co2-system-guide/">CO₂ system guide</a>.
Leak or unstable needle valve
Sudden dumps. Check <a href="https://aquaplantshub.com/co2-aquarium-leak-check/">leak check</a>.
Quick test: Hiss at fittings; gauge drops overnight.
Ammonia / nitrite mimicking gasp
Gills burn for a different reason.
Quick test: Liquid test toxic—follow chemistry playbooks.
Fix order
-
Step 1
Emergency: gas off + air on
Close CO₂ immediately, open surface agitation / air stone, lift the lid. Do not chase fish with nets.
Promotion threshold: if gasping stops within 5–10 minutes → stay on this step and go to water tests. If still gasping hard after 10 minutes with air on → skip to lookalikes / emergency WC (20–30%).
-
Step 2
Test water while they recover
Test NH₃/NO₂ first (liquid kits beat strips). If ammonia or nitrite >0 → treat as cycle crash, not “just CO₂”.
Promotion threshold: NH₃/NO₂ clean + drop checker yellow/lime after lights-on → CO₂/O₂ story is primary. Checker green/blue but still gasping → look for heat, gill disease, or clogged filter outflow.
-
Step 3
Retune injection
Aim checker green after 1–2h lights-on. Fix regulator/needle leaks. Timer: CO₂ off ~1h before lights-out so O₂ recovers overnight.
Promotion threshold: after 2 full light cycles, if checker still yellow at midday OR fish gasp only at lights-off → cut bubble rate 20–30% and recheck. No improvement in 48h → escalate to leak check + full CO₂ system review.
-
Step 4
Rule out lookalikes
Persistent white spots → ich. Melting fins → fin rot. Tank hot (heater stuck) cooking O₂ out → heater fault.
Promotion threshold: if symptoms match disease/heat more than gas timing, leave the CO₂ ladder and follow the matching guide instead of forcing more O₂ tweaks.
When to escalate
Escalate when:
– Drop checker stuck wrong color after retune → checker color meaning guide.
– Can’t find pressure loss → CO₂ leak check.
– Ammonia/nitrite positive → ammonia spike protocol.
– Gasping returns every lights-off for 3+ nights after bubble cut → redesign diffusion / surface movement (CO₂ system guide).
Do not keep lowering fish load as the first fix when the checker is yellow — fix gas and O₂ first.
Helpful products
Related guides
- Drop checker colors — Tune
- CO₂ leak check — Hardware
- CO₂ system guide — Hub
- Ich treatment — Differential
FAQ
Should I water-change during a CO₂ overdose?
Air off the gas first. A WC helps if you also spiked nutrients—but agitation is the priority.
Is yellow drop checker always bad?
Lime/yellow with piping fish = turn down now. Brief flashes while tuning can happen.
Can low O₂ happen without CO₂?
Yes—power outage, sealed lid, high temp. Still treat as oxygen emergency.
Shrimp climbing glass?
Same gas stress. Cut CO₂; don’t dose copper “cures.”
Related to filter flow?
Strong surface ripple helps off-gas CO₂—see flow guide.
Ich vs gasping?
Ich adds white spots. Pure gas crisis usually has no salt dots—still skim ich if spots appear.
Aqua Plants Hub Editorial

