Pool & Spa Chemical Calculator

How to use the pool chemical calculator

Poolboy Wizard helps homeowners plan pool and hot tub water care from their test results. Compare estimated chemical and water replacement costs, then print or share the inputs for a discussion with your pool professional.

1. Set up your pool or spa. Choose the vessel type, sanitizer, surface and water volume. Check whether your volume is in US gallons or liters.
2. Enter fresh test results. Replace the example readings with measurements from your water. Enter fill-water readings if you are considering water replacement. Follow your test kit's instructions.
3. Check targets and products. Review the suggested ranges against your equipment instructions. Match each chemical's concentration to the calculator label, select products you can use, and enter your local prices.
4. Review the estimated plan. Read the warnings and treatment order. Follow the product label, never mix chemicals together, and retest after treatment before deciding on the next addition.

The calculator needs JavaScript for interactive estimates. The guide and sources below remain readable without it.

How chemical doses and costs are estimated

The planner compares supported chemical additions and water replacement using your readings, targets, available products and prices. It accounts for modeled interactions between water parameters. Its selected plan is an estimate among the options evaluated, not a guarantee of the lowest possible cost or a prediction of every change in real water.

• Volume and units: the same concentration change needs more chemical in a larger pool. Most water readings use parts per million (ppm); phosphates use parts per billion (ppb), and pH is a logarithmic scale.
• Product strength: a dose applies to the concentration and chemical form shown in the calculator. Products with similar names can have different strengths. Purchase links do not verify the concentration in your container.
• Interacting readings: pH adjustment depends on buffering, including alkalinity. Stabilizer affects chlorine chemistry. Calcium hardness and total hardness are different measurements; a converted hardness value is an estimate.
• Precision: displayed doses and results are rounded. Extra decimal places do not make a test result or a pool-volume estimate more accurate. Retesting checks the actual response.
• Costs: estimates use the prices and units you enter. For example, 2 pounds at $3 per pound costs $6. This is a cost example, not a recommended dose. Taxes, delivery and labor may add to your total.

A projected target fit or saturation index is not a swimming-safety certificate. The model does not establish that water is free of pathogens or replace contamination-response guidance, product labels, equipment instructions or professional advice.

Understanding pool water replacement

Replacement water changes a dissolved concentration according to both the pool water and the fill water. For a single drain and refill, the ideal mixing estimate is: final concentration = (1 − fraction replaced) × starting concentration + fraction replaced × fill concentration. This assumes full mixing and no other additions or losses. It does not predict pH, sanitizer consumption or precipitation.

Worked dilution example: starting at 100 ppm with 0 ppm in the fill water, replacing 25% gives 75 ppm. Mixing completely and then replacing another 25% gives 56.25 ppm. The two stages use water equal to 50% of the pool volume, but remove 43.75% of the original dissolved material. In a 10,000-US-gallon pool, that is 2,500 gallons per stage and 5,000 gallons total.

This example explains dilution; it is not permission to drain your pool. A per-stage limit does not establish a structurally safe drain depth. Groundwater, pool construction and local discharge rules matter. Check with your builder or a qualified pool professional before draining.

Common pool and hot tub questions

How much chlorine or baking soda should I add?

Enter your measured reading, pool volume and desired range, then check the product strength. A dose from someone else's pool may not suit yours. The calculator estimates supported treatments; follow label limits and verify the result with a fresh test.

Can I use this for a hot tub or saltwater pool?

Choose the correct vessel and sanitization system in Setup. A salt chlorine generator still produces chlorine; use its manufacturer's salt range. Hot tubs need different care from pools. CDC advises against cyanuric acid and stabilized chlorine products in hot tubs. Bromine tablet dosing is not estimated here; follow the feeder and product instructions.

Will the calculator fix cloudy water or tell me it is safe to swim?

No. Cloudiness can involve circulation, filtration or contamination as well as chemistry. A plan based on entered readings cannot assess every cause or certify swimming safety. Consult appropriate water-safety guidance or a pool professional when conditions are uncertain.

Why can the actual result differ from the projection?

Test uncertainty, an inaccurate volume, product strength, incomplete mixing, sunlight, aeration and ongoing sanitizer demand can all change the outcome. Add treatments as directed, allow the required circulation time and retest instead of repeatedly applying an old plan.

Sources and model limitations

Use these references alongside product labels and your equipment manual. Public-pool standards and residential guidance have different scopes; a reference link is not an endorsement or certification of this calculator.

• CDC: home pool and hot tub water treatment and testing — residential testing, chlorine, pH and stabilizer guidance.
• ANSI/PHTA/ICC-11 water-quality standard — public pool and spa water-quality reference.
• Wahman and Alexander: free chlorine and cyanuric acid model — research underlying modeled chlorine/cyanurate chemistry.

Estimates depend on the supported chemical forms and equilibrium assumptions. They do not model all products, reaction rates or operating conditions. In particular, do not substitute total hardness for a measured calcium hardness without recognizing the uncertainty, and do not treat an unmeasured optional reading as zero.

About Poolboy Wizard & your data

Poolboy Wizard is a free planning tool for pool and spa owners, with printable plans and shareable inputs for conversations with pool professionals. Use Feedback to report an issue or contact the maintainer. No professional certification or independent expert endorsement is claimed.

Saved profiles and readings are stored in this browser. Share links encode plan inputs, so anyone you send a link to can read those inputs. Avoid including personal information in profile names or shared content.

The site uses Umami analytics and session replay to understand usage and investigate problems. Analytics can record interactions, performance, shared-input payloads and submitted feedback, including an email address if you provide one. Replay masking may not conceal every detail; do not enter sensitive information. Feedback is sent to the site's feedback service. Browser storage is not a promise that all interactions stay on your device.

As an Amazon Associate, the maintainer earns from qualifying purchases at no extra cost to you. Purchase links support the tool's upkeep. Enter your own prices and check product labels; linked products are not guaranteed to be the cheapest or suitable for your treatment.