Hot Tub Troubleshooting: Cloudy Water, Foam, Error Codes & No Heat — A Decision Tree

Something’s wrong with your hot tub. Don’t panic, and don’t start throwing chemicals at it in random order — troubleshooting is a process of elimination, and there’s a right order. This guide walks you through the five most common problems as decision trees: start at the top of your symptom, work down, and stop when the water clears up. If you reach a “call a tech” step, that’s an honest endpoint — some things genuinely need a professional.

If you’re new to water chemistry, read our hot tub chemicals beginner’s guide first — the troubleshooting below assumes you can test sanitizer, pH, and alkalinity with strips or a drop kit. When a tree tells you to add a specific dose, use our chemical dosing calculator rather than guessing.

Tree 1: Cloudy water

Cloudy water means something is suspended in it — dead organisms, oils, or tiny particles the filter isn’t catching. Work this order; each step is cheaper and more likely than the next.

1. Test the sanitizer. Strips or drop kit: free chlorine should be roughly 2–4 ppm (bromine 3–6 ppm). If it’s low, that’s your prime suspect — the sanitizer isn’t keeping up with the bather load. Dose back to target and retest in 30 minutes with the circulation running.
2. Check and clean the filter. Pull the cartridge(s) and rinse them thoroughly with a hose — grease and debris clog media fast in hot tubs. If the pleats look collapsed, gray, or the cartridge is more than a year old, replace it. Run the jets and recheck clarity in a few hours.
3. Check pH and alkalinity. pH roughly 7.2–7.8, total alkalinity roughly 80–120 ppm. High pH makes water cloudy and reduces sanitizer effectiveness. Adjust alkalinity first, then pH — never the reverse (full explanation in the dosing calculator page).
4. Shock the water. If sanitizer, filter, and pH are all fine but the water is still dull, oxidize: add a non-chlorine (MPS) shock or a chlorine shock per the product label, circulation running, cover off, and leave it for several hours. This burns off the organics the sanitizer alone can’t clear.
5. Check the water’s age. Hot tub water has a lifespan. A widely used rule of thumb (TroubleFreePool) is: water replacement interval in days ≈ gallons ÷ 3 ÷ average daily bathers. A 400-gallon tub with two daily users = ~67 days. If your water is older than that and nothing else works, drain and refill — no amount of chemistry fixes exhausted water.
6. Still cloudy? Suspect biofilm in the plumbing (slimy buildup in the pipes). Run a plumbing/purge cleaner through the system per its label before the next drain-and-refill. If that fails too → call a tech.

Tree 2: Foam on the water

Foam is almost never a chemistry problem to solve with chemicals first. Identify the cause:

1. Think about what went in the water. Swimsuits washed with laundry detergent, soap or shampoo residue from showering (or not showering before soaking), lotions, hair products, body oils — these are the cause of foam in the overwhelming majority of cases.
2. Test sanitizer anyway. Low sanitizer lets body oils accumulate and foam. If low, dose up — it won’t instantly kill foam, but it stops it getting worse.
3. Skim and shock. Scoop out the foam with the net, then shock per the label to oxidize the contaminants. Scrub the waterline — foam clings there and re-seeds itself.
4. Defoamer (temporary). Anti-foam products knock foam down fast, but they’re cosmetic — they treat the symptom, not the cause. Use only if the cause is already addressed.
5. Still foaming after a day or two? The contaminants are embedded: clean the filter (detergents live in filter media), and if that fails, drain, wipe down the shell, clean the filters, and refill. Fresh water plus a “shower before soaking, no detergent on suits” rule prevents recurrence.

Tree 3: Error codes on the display

Honest disclaimer up front: error codes are not standardized. “E02” on one brand means nothing on another, and we will not pretend to decode your specific model here. What we can give you is the

diagnostic order that applies to nearly every code, and how to read the one that matters — yours.

Bestway Lay-Z-Spa owners get one exception to that disclaimer: we maintain a complete error code reference for the Lay-Z-Spa pump platform — every code, what it means, and the fix to try first.

1. Read your manual. Find the exact code in your tub’s manual or the manufacturer’s site. That single step resolves most error-code panics.
2. Check the water level. If water is below the skimmer or intake openings, pumps suck air and throw flow-related codes. Top up to the fill line.
3. Check the filter. A dirty filter is the #1 cause of flow codes. Pull, rinse, or swap in a spare and see if the code clears.
4. Check valves and the breaker. Make sure any slice/gate valves on the plumbing are fully open (they sometimes get bumped during filter changes). Check the GFCI breaker isn’t tripped — if it trips again after resetting, stop and call a tech; that’s a fault, not a nuisance.
5. Power-cycle the tub. Turn it off at the breaker for a full minute, then back on. Transient sensor glitches clear this way. If the code returns immediately, it’s real.
6. Code still present? You’ve now eliminated water level, filter, valves, and power. What’s left — heater elements, sensors, the control board — is call-a-tech territory. Note the exact code, the tub’s brand and model, and what you already tried; that saves you a diagnostic hour of labor.

Tree 4: The tub won’t heat

Work from the cheapest, most common causes downward. Electrical safety rule applies throughout.

1. Check the settings. Confirm the target temperature is actually set where you think it is, and the tub isn’t in economy/sleep/vacation mode (these deliberately limit heating — check the manual for how your model labels its modes).
2. Check power. Is the GFCI breaker tripped? Is the tub getting power at all (display lit, pump running)? If the breaker trips when reset → call a tech, do not keep resetting it.
3. Check water level and the filter. Heaters shut off or underperform when flow is restricted — low water or a clogged filter is the most common “heater problem” that isn’t the heater. Top up, clean the filter, and give it several hours.
4. Is the circulation pump running? No circulation = no heat distribution and often a heater lockout. If the pump is silent or humming without moving water, that’s the fault to fix (airlock after a refill is common — “burping” the pump per the manual often clears it).
5. Check the cover. A waterlogged, cracked, or missing cover bleeds heat faster than a small heater can replace, especially in cold weather. If the tub heats slowly but never reaches temperature, suspect heat loss before a dead heater. Inflatable models lose heat faster than hard-shells by design — if you’re shopping, our inflatable hot tub hub compares models with insulation in mind.
6. Still cold after 24 hours of good flow and power? The heater element or thermostat has likely failed. Elements corrode and burn out — this is a wear item, not a mystery. → Call a tech (element replacement is routine for them, hazardous for you).

Tree 5: Bad smell or itchy/irritated skin

1. Identify the smell. A strong “chlorine” smell is counterintuitive: it usually means chloramines — combined chlorine formed when sanitizer reacts with sweat, oils, and urine. It signals too little effective sanitizer, not too much. The fix is shocking, not reducing chlorine.
2. Test everything. Sanitizer (FC 2–4 ppm chlorine / 3–6 ppm bromine), pH 7.2–7.8, alkalinity 80–120 ppm. High pH and high sanitizer both irritate skin and eyes.
3. If sanitizer is high (well above target): stop adding it, leave the cover off with circulation running (UV and aeration bring it down), and don’t soak until it’s back in range. Neutralizer products exist but patience is free.
4. If sanitizer is low with a chloramine smell: shock per the label, cover off, and wait for levels to normalize before soaking. This is the single most common “my hot tub smells” resolution.
5. If levels are all fine but skin still itches: suspect high total dissolved solids or old water (see the water-age rule in Tree 1), or individual sensitivity — some people react to bromine or MPS shock. A partial or full drain-and-refill with fresh, balanced water is the test. If irritation persists with fresh balanced water, talk to a doctor, not a hot tub forum.

When to call a professional — the honest list

• Breaker trips repeatedly, or any burning/electrical smell.
• Pump hums but doesn’t move water after you’ve checked level, filter, and airlock.
• Heater won’t heat with confirmed power, flow, and settings.
• Error code persists after level/filter/valves/power-cycle elimination.
• Any leak you can’t trace to a loose union or drain cap.
• Water problems that survive two full passes through the relevant tree.

None of these are failures — they’re the boundary where a $100–$200 service visit is cheaper than the parts you’d guess at replacing.

Quick-reference: the order that fixes 90% of problems

For almost any water complaint: test → dose sanitizer → clean the filter → balance pH/alkalinity → shock → check water age. Print that on a card and keep it with your test kit. Most “mystery” problems are step one or two.

Frequently asked questions

How often should I drain and refill my hot tub?

Every 3–4 months for typical use is the standard guidance; heavy use shortens it. The gallons ÷ 3 ÷ daily bathers rule of thumb (per TroubleFreePool) gives a personalized interval. When in doubt, fresh water is the cheapest fix in hot tub ownership.

Can I use pool chemicals in my hot tub?

Sometimes, carefully: plain unscented bleach and baking soda are chemically identical to spa products, but concentrations and dosing differ, and some pool products (notably trichlor tablets) are wrong for the small water volume and heat of a spa. Always dose for spa volumes with the dosing calculator, and never mix products.

Why does my hot tub smell like chlorine right after shocking?

Temporarily normal — shocking oxidizes chloramines and the smell spikes before it clears. Leave the cover off with circulation running and wait for sanitizer to fall back into range before soaking.

Is cloudy water safe to soak in?

If you don’t know why it’s cloudy, no. Cloudy water can mean inadequate sanitation, and inadequate sanitation can mean bacteria. Fix it first (Tree 1), verify sanitizer and pH in range, then soak.

Methodology note: this guide synthesizes standard spa-maintenance guidance from manufacturer manuals and the TroubleFreePool community’s widely used water-chemistry references. Ranges given are typical starting points — always follow your specific product labels, which override general advice. We don’t do lab testing and don’t claim to; this is compiled practical knowledge, not original research.