Water Hardness Calculator with Steps (Free) | StatsUnlock

A water hardness calculator uses total hardness (mg/L as CaCO₃) = 2.497 × Ca + 4.118 × Mg, with calcium and magnesium in mg/L. For Ca = 40 mg/L and Mg = 10 mg/L: 99.9 + 41.2 = 141.1 mg/L as CaCO₃ (141 ppm), which is 8.24 grains per gallon and 7.90 °dH: hard water on the USGS scale.

Rule of thumb: under 60 mg/L (3.5 gpg) is soft; over 120 mg/L (7 gpg) is hard enough that a water softener is often worth considering. Set the softener to your hardness in grains per gallon, plus 4 for each ppm of iron.

Water hardness is the total of the dissolved divalent metal ions, almost entirely calcium (Ca²⁺) and magnesium (Mg²⁺), picked up as water passes through limestone, dolomite and gypsum. Because the two ions have different masses, hardness is reported as the mass of calcium carbonate that would contain the same number of ions: mg/L as CaCO₃, which equals ppm as CaCO₃. Hard water forms scale in kettles, pipes and water heaters and stops soap from lathering; it is not a health hazard, and reviews of drinking-water studies link magnesium-rich hard water with modestly lower cardiovascular mortality (Monarca et al., 2006). A water hardness calculator applies the conversion factors exactly, from ions, from a titration or from another unit.

A worked one-liner: TH = 2.497 × 40 + 4.118 × 10 = 99.9 + 41.2 = 141.1 mg/L as CaCO₃; ÷ 17.12 = 8.24 gpg; ÷ 17.85 = 7.90 °dH.

Who uses it: chemistry students doing the EDTA hardness practical; water and wastewater operators; well owners reading a lab report; homeowners setting a water softener or dishwasher; aquarium keepers converting °dH (GH); and engineers designing lime softening. One page replaces separate hardness, ppm to gpg and softener calculators.

Quick answers to the questions people ask most

4.1 What the result means

___

4.2 The formula

___

4.3 The detail that changes the answer

___

4.4 Context

___

4.5 What to do next

___

4.6 Why express hardness as CaCO₃?

Calcium (40.078 g/mol) and magnesium (24.305 g/mol) carry the same charge, so one millimole of either removes the same amount of soap and forms the same amount of scale. Adding their masses directly would undercount magnesium. Converting both to the mass of CaCO₃ (100.086 g/mol) that contains the same number of ions puts them on one scale: 1 mmol/L of hardness is always 100.09 mg/L as CaCO₃, whichever ion supplies it. The factors 2.497 and 4.118 come straight from the IUPAC atomic weights (Prohaska et al., 2022).

4.7 Temporary and permanent hardness

Hardness paired with bicarbonate is carbonate or temporary hardness: heating drives off CO₂ and deposits CaCO₃ as scale, which is why kettles fur up. Hardness paired with sulfate, chloride or nitrate is non-carbonate or permanent hardness and survives boiling. Because alkalinity is also reported as CaCO₃, the split is simply the smaller of the two numbers.

4.8 Hardness and health

Hardness is an aesthetic and engineering issue, not a contaminant, and WHO sets no health-based guideline value. Observational studies associate magnesium in drinking water with lower cardiovascular mortality (Catling et al., 2008; Jiang et al., 2016), and hard water is linked with eczema in infants (Perkin et al., 2016), although a randomized trial of household softeners found no clear benefit for children with eczema (Thomas et al., 2011).

A hardness value in a report needs the number, the unit and its basis (mg/L as CaCO₃, not just mg/L), the method (calculation from Ca and Mg, or EDTA titration) and, for measured values, the uncertainty. The seven write-ups below are filled from the water hardness calculator; they show the headline example until you press Calculate.

Showing the headline example (Ca 40 mg/L, Mg 10 mg/L). Press Calculate above to fill all seven write-ups with your own result.

5.1 Style rules

5.2 Seven ready-to-copy write-ups

The same worked problem as Sections 0, 9, 10, 11 and 14: calcium 40 mg/L and magnesium 10 mg/L.

1. Pick what you want to calculate. Choose a mode in Section 2: hardness from calcium and magnesium, from an EDTA titration, a unit conversion, a water softener setting, or carbonate and non-carbonate hardness.
2. Load a sample or type your values. Twelve worked problems are in the sample menu. Sample 1 is the headline problem. Nothing is calculated until you press Calculate Hardness.
3. Check the units of your data. Calcium and magnesium can be in mg/L of the ion, mmol/L or meq/L. Values already reported as CaCO3 go in the converter instead.
4. Add optional ions or alkalinity. Strontium, iron, manganese and barium count toward hardness; total alkalinity splits carbonate from non-carbonate hardness.
5. For a titration, enter volumes and molarity. EDTA volume, its molarity and the sample volume; optionally a reagent blank, a calcium-only titration and glassware tolerances.
6. For a softener, describe the household. Hardness, iron, number of people, gallons per person and days between regenerations; add your softener capacity to get its regeneration interval.
7. Press Calculate Hardness. Press the button or Enter. The hardness in every unit, its class, a Verified badge, the formula and every step appear in Section 3.
8. Read the figure and charts. The figure places your water on the USGS hardness scale; four charts show where the hardness comes from, its class, its units and its sensitivity.
9. Copy the write-up. Section 5 fills seven ready texts for a report, a log, code, an exam, chat, a results paragraph and a table.
10. Download or run a batch. Download Doc or PDF, or calculate many samples at once from a CSV of calcium and magnesium in the Batch tab.

Excel has no hardness function, but the formulas are one line each. The sheet repeats the headline problem (Ca 40 mg/L, Mg 10 mg/L), so the numbers match Sections 0, 7, 10, 11 and 14.

9.1 The formulas you need

9.2 Step by step

9.3 Many samples

Paste calcium and magnesium for every sample into columns A and B, select C2:F2 and fill down. Add the IFS formula in G to label each sample soft, moderately hard, hard or very hard.

9.4 Why Excel may differ from R or Python

9.5 Charting

Select columns C and D and insert a Stacked Bar chart to show calcium and magnesium hardness for each sample. Add vertical lines at 60, 120 and 180 for the USGS classes.

9.6 Errors you may see

• #VALUE!: a unit typed into a number cell.
• #DIV/0!: the sample volume cell is empty.
• A hardness 2.5 times too high: the calcium value was already “as CaCO₃”.

A complete, copy-and-run script that reproduces the water hardness calculator for the headline problem. It calculates total hardness from calcium 40 mg/L and magnesium 10 mg/L, converts it to every unit, classifies it, works an EDTA titration with its uncertainty, sizes a water softener and saves one 300 dpi figure.

10.1 The complete script

R, base only, saves water_hardness.png

# Water hardness calculator in base R (StatsUnlock)
M <- c(Ca = 40.078, Mg = 24.305, CaCO3 = 100.086, CaO = 56.077)
hardness <- function(ca, mg) {
  if (any(c(ca, mg) < 0)) stop("concentrations cannot be negative")
  M["CaCO3"] * (ca / M["Ca"] + mg / M["Mg"])          # mg/L as CaCO3
}
units <- c(gpg = 64.79891 / 3.785411784, dH = 10 * M[["CaCO3"]] / M[["CaO"]], fH = 10,
           e = 64.79891 / 4.54609, mmol = M[["CaCO3"]], meq = M[["CaCO3"]] / 2)
usgs <- function(th) cut(th, c(-Inf, 60, 120, 180, Inf),
                         labels = c("Soft", "Moderately hard", "Hard", "Very hard"))
# headline: Ca 40 mg/L, Mg 10 mg/L
ca <- 40; mg <- 10
th <- unname(hardness(ca, mg))
cat(sprintf("Ca hardness %.1f + Mg hardness %.1f = TH %.2f mg/L as CaCO3\n",
            2.497 * ca, 4.118 * mg, th))
print(round(th / units, 3))
cat("USGS class:", as.character(usgs(th)), "\n")
# EDTA titration: 12.5 mL of 0.01 M EDTA, 50 mL sample, tolerances a
v <- 12.5; m <- 0.01; vs <- 50
th_t <- v * m * 100086 / vs
urel <- sqrt((0.05 / sqrt(3) / v)^2 + (0.0001 / sqrt(3) / m)^2 + (0.05 / sqrt(3) / vs)^2)
cat(sprintf("EDTA: TH = %.1f +/- %.1f mg/L (U, k = 2)\n", th_t, 2 * urel * th_t))
# softener: 15 gpg, 1 ppm iron, 4 people x 75 gal, 7 days
setting <- 15 + 4 * 1; per_day <- 4 * 75 * setting
cat(sprintf("Softener setting %d gpg; %d grains/day; %d grains for 7 days\n",
            setting, per_day, per_day * 7))
png("water_hardness.png", width = 7, height = 4, units = "in", res = 300)
barplot(matrix(c(2.497 * ca, 4.118 * mg)), horiz = TRUE, col = c("#2563eb", "#0d9488"),
        xlim = c(0, 250), xlab = "mg/L as CaCO3", legend.text = c("Ca", "Mg"))
abline(v = c(60, 120, 180), lty = 2, col = "grey40")
invisible(dev.off())

10.2 Output

Ca hardness 99.9 + Mg hardness 41.2 = TH 141.07 mg/L as CaCO3
   gpg     dH     fH      e   mmol    meq 
 8.241  7.904 14.107  9.897  1.409  2.819 
USGS class: Hard 
EDTA: TH = 250.2 +/- 3.1 mg/L (U, k = 2)
Softener setting 19 gpg; 5700 grains/day; 39900 grains for 7 days

10.3 Traps

• hardness() is vectorized: pass whole columns of a data frame.
• cut() labels the USGS class; the intervals are closed on the right (60 is soft).
• Use mg/L of the ion, not values already “as CaCO₃”.

10.4 What each part does

10.5 Adapting it

Change ca and mg for your sample, or pass whole columns: the functions are vectorized and work on a data frame of many samples at once.

A complete, copy-and-run script that reproduces the water hardness calculator for the headline problem. It calculates total hardness from calcium 40 mg/L and magnesium 10 mg/L, converts it to every unit, classifies it, works an EDTA titration with its uncertainty, sizes a water softener and saves one 300 dpi figure.

Install once: pip install numpy matplotlib

11.1 The complete script

Python with NumPy and Matplotlib, saves water_hardness.png

# Water hardness calculator in Python (StatsUnlock)
import numpy as np
import matplotlib.pyplot as plt

M = {"Ca": 40.078, "Mg": 24.305, "CaCO3": 100.086, "CaO": 56.077}
UNITS = {"gpg": 64.79891 / 3.785411784, "dH": 10 * M["CaCO3"] / M["CaO"], "fH": 10.0,
         "e": 64.79891 / 4.54609, "mmol": M["CaCO3"], "meq": M["CaCO3"] / 2}

def hardness(ca, mg):
    """Total hardness, mg/L as CaCO3, from Ca and Mg in mg/L."""
    ca, mg = np.asarray(ca, float), np.asarray(mg, float)
    if (ca < 0).any() or (mg < 0).any():
        raise ValueError("concentrations cannot be negative")
    return M["CaCO3"] * (ca / M["Ca"] + mg / M["Mg"])

def usgs(th):
    return "Soft" if th <= 60 else "Moderately hard" if th <= 120 else "Hard" if th <= 180 else "Very hard"

ca, mg = 40, 10                                   # headline sample, mg/L
th = float(hardness(ca, mg))
print(f"Ca hardness {2.497 * ca:.1f} + Mg hardness {4.118 * mg:.1f} = TH {th:.2f} mg/L as CaCO3")
print({k: round(th / f, 3) for k, f in UNITS.items()})
print("USGS class:", usgs(th))

v, m, vs = 12.5, 0.01, 50                         # EDTA titration
th_t = v * m * 100086 / vs
urel = np.sqrt((0.05 / np.sqrt(3) / v) ** 2 + (0.0001 / np.sqrt(3) / m) ** 2 + (0.05 / np.sqrt(3) / vs) ** 2)
print(f"EDTA: TH = {th_t:.1f} +/- {2 * urel * th_t:.1f} mg/L (U, k = 2)")

setting = 15 + 4 * 1                              # softener: 15 gpg + 4 x 1 ppm iron
per_day = 4 * 75 * setting
print(f"Softener setting {setting} gpg; {per_day} grains/day; {per_day * 7} grains for 7 days")

fig, ax = plt.subplots(figsize=(7, 3))
ax.barh([0], [2.497 * ca], color="#2563eb", label="Ca")
ax.barh([0], [4.118 * mg], left=[2.497 * ca], color="#0d9488", label="Mg")
for x in (60, 120, 180):
    ax.axvline(x, ls="--", c="grey")
ax.set_xlim(0, 250); ax.set_yticks([]); ax.set_xlabel("mg/L as CaCO3"); ax.legend()
fig.tight_layout(); fig.savefig("water_hardness.png", dpi=300)

11.2 Output

Ca hardness 99.9 + Mg hardness 41.2 = TH 141.07 mg/L as CaCO3
{'gpg': 8.241, 'dH': 7.904, 'fH': 14.107, 'e': 9.897, 'mmol': 1.409, 'meq': 2.819}
USGS class: Hard
EDTA: TH = 250.2 +/- 3.1 mg/L (U, k = 2)
Softener setting 19 gpg; 5700 grains/day; 39900 grains for 7 days

11.3 Traps

• hardness() accepts lists or arrays, so a pandas column works directly.
• Use / not // so integer inputs are not truncated.
• Raise an error for negative concentrations instead of returning a number.

11.4 What each part does

11.5 Adapting it

Change ca and mg for your sample, or pass whole columns: the functions are vectorized and work on a data frame of many samples at once.

12.1 Grains per gallon to ppm, °dH, °fH and mmol/L

1 gpg = 64.79891 mg ÷ 3.785412 L = 17.1185 mg/L; 1 °dH = 17.848 mg/L. Exact. Last checked: October 2026.

12.2 ppm to grains per gallon chart

gpg = ppm ÷ 17.1185. Last checked: October 2026.

12.3 Water hardness scales

USGS classes as used in US Geological Survey water-quality reports; softener classes as printed by the water treatment industry; German classes from the Washing and Cleaning Agents Act. Last checked: October 2026.

12.4 Hardness factors for each ion

Molar masses from the IUPAC standard atomic weights (Prohaska et al., 2022); CaCO₃ = 100.086 g/mol. Last checked: October 2026.

12.5 Water softener size by household and hardness

75 US gallons per person per day; add 4 gpg per ppm of iron before using the table. Last checked: October 2026.

12.6 EDTA titration quick lookup (0.0100 M EDTA)

TH = V × 0.0100 × 100,086 ÷ V(sample); for 0.0200 M EDTA, double every value. Last checked: October 2026.

Eight worked problems that cover what a water hardness calculator meets: a textbook ion calculation, an EDTA practical, a utility report, a well-water softener, an aquarium, a European dishwasher, boiler scale and the classic mistake. Each number was checked in Python.

The written method, calculator keys and the EDTA titration procedure, for the headline problem: Ca 40 mg/L and Mg 10 mg/L.

14.1 The written method

1. Check the units. Ca and Mg in mg/L of the ion.
2. Calcium hardness. 40 × 2.497 = 99.9 mg/L as CaCO₃.
3. Magnesium hardness. 10 × 4.118 = 41.2 mg/L as CaCO₃.
4. Add. 99.9 + 41.2 = 141.1 mg/L (ppm) as CaCO₃.
5. Convert. 141.1 ÷ 17.12 = 8.24 gpg; ÷ 17.85 = 7.90 °dH.
6. Check. 40/40.078 + 10/24.305 = 1.409 mmol/L × 100.086 = 141.1 ✓

14.2 On a calculator

14.3 Lab SOP: total hardness by EDTA titration (Standard Methods 2340 C)

14.4 Practice problems

14.5 Mistakes that lose marks

• Adding the ion masses instead of their CaCO₃ equivalents.
• Forgetting “as CaCO₃” in the unit.
• Using mL instead of L for the sample volume.
• Leaving out the blank.
• Confusing °dH and °fH.
• Classifying without naming the scale.

14.6 Check-yourself and lab questions

Almost every wrong hardness value comes from a unit basis, a factor or the titration endpoint. The water hardness calculator guards against each one below.

Hardness is not regulated as a health contaminant in the US; several EU countries set minimum or recommended calcium and magnesium levels (Kožíšek, 2020). This calculator gives chemistry and softener sizing, not medical or engineering certification.

Your result

The water hardness calculator gives 141.1 mg/L CaCO₃ (8.24 gpg, 7.90 °dH): hard water. Hardness = 2.497 Ca + 4.118 Mg, in mg/L as CaCO₃.

What the water hardness calculator does

Water hardness is one idea, divalent metal ions counted as CaCO₃, reported in half a dozen units and measured in two main ways. This water hardness calculator works from calcium and magnesium or an EDTA titration, converts between ppm, gpg, °dH, °fH, °e and mmol/L, sizes and sets a water softener, and splits carbonate from non-carbonate hardness, with every step shown.

Watch out for

• mg/L of the ion is not mg/L as CaCO₃.
• Subtract the titration blank.
• 1 gpg = 17.12 ppm, not 17.
• Add iron to the softener setting.
• Name the class’s scale.

Next steps

To make EDTA and calcium standards, use the molarity calculator and dilution calculator; for brine strength, the specific gravity calculator. Whatever the unit, start and finish with the water hardness calculator.

More lab, chemistry and measurement tools from StatsUnlock, with worked steps, code and references.

Peer-reviewed sources behind this water hardness calculator: IUPAC atomic weights, EDTA complexometric titration, ion-exchange softening, calcium and magnesium in tap and bottled water, hardness and health, regulation, and measurement uncertainty. Standards (APHA Standard Methods 2340 B and C, JCGM 100:2008, NSF/ANSI 44) are named where they are used. Every DOI checked October 2026.

1. Apell, J. N., & Boyer, T. H. (2010). Combined ion exchange treatment for removal of dissolved organic matter and hardness. Water Research, 44(8), 2419–2430. https://doi.org/10.1016/j.watres.2010.01.004
2. Azoulay, A., Garzon, P., & Eisenberg, M. J. (2001). Comparison of the mineral content of tap water and bottled waters. Journal of General Internal Medicine, 16(3), 168–175. https://doi.org/10.1111/j.1525-1497.2001.04189.x
3. Brastad, K. S., & He, Z. (2013). Water softening using microbial desalination cell technology. Desalination, 309, 32–37. https://doi.org/10.1016/j.desal.2012.09.015
4. Catling, L. A., Abubakar, I., Lake, I. R., Swift, L., & Hunter, P. R. (2008). A systematic review of analytical observational studies investigating the association between cardiovascular disease and drinking water hardness. Journal of Water and Health, 6(4), 433–442. https://doi.org/10.2166/wh.2008.054
5. Cole, T. J. (2015). Too many digits: The presentation of numerical data. Archives of Disease in Childhood, 100(7), 608–609. https://doi.org/10.1136/archdischild-2014-307149
6. Danby, S. G., Brown, K., Wigley, A. M., Chittock, J., Pyae, P. K., Flohr, C., & Cork, M. J. (2018). The effect of water hardness on surfactant deposition after washing and subsequent skin irritation in atopic dermatitis patients and healthy control subjects. Journal of Investigative Dermatology, 138(1), 68–77. https://doi.org/10.1016/j.jid.2017.08.037
7. Goldberg, D. (1991). What every computer scientist should know about floating-point arithmetic. ACM Computing Surveys, 23(1), 5–48. https://doi.org/10.1145/103162.103163
8. Jiang, L., He, P., Chen, J., Liu, Y., Liu, D., Qin, G., & Tan, N. (2016). Magnesium levels in drinking water and coronary heart disease mortality risk: A meta-analysis. Nutrients, 8(1), 5. https://doi.org/10.3390/nu8010005
9. Kožíšek, F. (2020). Regulations for calcium, magnesium or hardness in drinking water in the European Union member states. Regulatory Toxicology and Pharmacology, 112, 104589. https://doi.org/10.1016/j.yrtph.2020.104589
10. Kragten, J. (1994). Calculating standard deviations and confidence intervals with a universally applicable spreadsheet technique. Analyst, 119(10), 2161–2165. https://doi.org/10.1039/AN9941902161
11. Monarca, S., Donato, F., Zerbini, I., Calderon, R. L., & Craun, G. F. (2006). Review of epidemiological studies on drinking water hardness and cardiovascular diseases. European Journal of Cardiovascular Prevention & Rehabilitation, 13(4), 495–506. https://doi.org/10.1097/01.hjr.0000214608.99113.5c
12. Morr, S., Cuartas, E., Alwattar, B., & Lane, J. M. (2006). How much calcium is in your drinking water? A survey of calcium concentrations in bottled and tap water and their significance for medical treatment and drug administration. HSS Journal, 2(2), 130–135. https://doi.org/10.1007/s11420-006-9000-9
13. Newell, D. B., Cabiati, F., Fischer, J., Fujii, K., Karshenboim, S. G., Margolis, H. S., de Mirandés, E., Mohr, P. J., Nez, F., Pachucki, K., Quinn, T. J., Taylor, B. N., Wang, M., Wood, B. M., & Zhang, Z. (2018). The CODATA 2017 values of h, e, k, and N_A for the revision of the SI. Metrologia, 55(1), L13–L16. https://doi.org/10.1088/1681-7575/aa950a
14. Perkin, M. R., Craven, J., Logan, K., Strachan, D., Marrs, T., Radulovic, S., Campbell, L. E., MacCallum, S. F., McLean, W. H. I., Lack, G., & Flohr, C. (2016). Association between domestic water hardness, chlorine, and atopic dermatitis risk in early life: A population-based cross-sectional study. Journal of Allergy and Clinical Immunology, 138(2), 509–516. https://doi.org/10.1016/j.jaci.2016.03.031
15. Prohaska, T., Irrgeher, J., Benefield, J., Böhlke, J. K., Chesson, L. A., Coplen, T. B., Ding, T., Dunn, P. J. H., Gröning, M., Holden, N. E., Meijer, H. A. J., Moossen, H., Possolo, A., Takahashi, Y., Vogl, J., Walczyk, T., Wang, J., Wieser, M. E., Yoneda, S., Zhu, X.-K., & Meija, J. (2022). Standard atomic weights of the elements 2021 (IUPAC Technical Report). Pure and Applied Chemistry, 94(5), 573–600. https://doi.org/10.1515/pac-2019-0603
16. Rubenowitz, E., Molin, I., Axelsson, G., & Rylander, R. (2000). Magnesium in drinking water in relation to morbidity and mortality from acute myocardial infarction. Epidemiology, 11(4), 416–421. https://doi.org/10.1097/00001648-200007000-00009
17. Thomas, K. S., Dean, T., O’Leary, C., Sach, T. H., Koller, K., Frost, A., Williams, H. C., & the SWET Trial Team. (2011). A randomised controlled trial of ion-exchange water softeners for the treatment of eczema in children. PLoS Medicine, 8(2), e1000395. https://doi.org/10.1371/journal.pmed.1000395
18. Tiesinga, E., Mohr, P. J., Newell, D. B., & Taylor, B. N. (2021). CODATA recommended values of the fundamental physical constants: 2018. Reviews of Modern Physics, 93(2), 025010. https://doi.org/10.1103/RevModPhys.93.025010
19. Yang, C.-Y. (1998). Calcium and magnesium in drinking water and risk of death from cerebrovascular disease. Stroke, 29(2), 411–414. https://doi.org/10.1161/01.STR.29.2.411
20. Yappert, M. C., & DuPré, D. B. (1997). Complexometric titrations: Competition of complexing agents in the determination of water hardness with EDTA. Journal of Chemical Education, 74(12), 1422. https://doi.org/10.1021/ed074p1422