Pool Monitor Card

Keep your swimming pool safe and crystal clear by monitoring up to 25 water chemistry parameters at a glance.

Visual editor included — configure everything from the UI, no YAML needed.

See all configurations and visual tests

Upgrading from v1? The sensor configuration format changed in v2. See the Migration Guide.

Why this card?

Whether you have a chlorine pool, a saltwater system, or a heated spa, this card gives you an instant visual overview of your water quality — right from your Home Assistant dashboard.

Color-coded gradient bars show you at a glance if each parameter is in its ideal range. No need to memorize numbers or look up charts.

Preset ideal ranges for all 20 pool parameters mean you can get started with just an entity ID — the card knows what "good" looks like for pool water.

What you can do

• Check if the water is safe before letting the kids swim
• Monitor pH and ORP trends after adding chemicals to see the effect over time
• Track chlorine levels to catch sanitization drops early
• Watch filter pressure to know when to backwash
• Compare pool vs. spa temperature with multiple sensors per type

Sensors (25 presets)

Every sensor comes with preset ideal ranges — just point to your entity and the card handles the rest. Override any value to match your setup.

Essential Water Chemistry

The core parameters every pool owner should monitor for safe, comfortable swimming.

Chemical Balance

Keeping these balanced prevents algae, scaling, and equipment damage.

Treatment & Sanitization

These tell you if your disinfection system is working properly.

Equipment & Maintenance

Track the health of your pool equipment and supply levels.

Hayward OmniLogic users: The chlorinator, pump_speed and heat_pump_setpoint presets map directly to OmniLogic entities (sensor.*_chlorinator_setting, sensor.*_pump_speed, etc.). Use availability_entity to gray out equipment rows when the device is off.

For detailed explanations of each sensor and why it matters, see Sensor Details.

Compatible Hardware

Community-tested devices and their supported parameters:

✔️ = supported, ❌ = not supported. See more hardware

Know a device that works? Open an issue to add it!

Installation

HACS (recommended)

1. Open HACS → Frontend → search for Pool Monitor Card
2. Install and reload your browser

Manual

1. Download pool-monitor-card.js from the latest release
2. Copy to config/www/community/pool-monitor-card/
3. Add resource: /local/community/pool-monitor-card/pool-monitor-card.js (type: module)

Quick Start

Visual Editor (recommended)

1. In your dashboard, click Edit Dashboard (pencil icon)
2. Click + Add Card → select Manual → type custom:pool-monitor-card
3. Click Show Visual Editor to configure sensors, display options and colors — no YAML needed

YAML

type: custom:pool-monitor-card
title: "My Pool"
sensors:
  temperature:
    entity: sensor.your_temperature_sensor
  ph:
    entity: sensor.your_ph_sensor
  orp:
    entity: sensor.your_orp_sensor

That's it! The card uses sensible defaults for everything else.

Configuration

All options below are also available in the visual editor.

Per-sensor options

sensors:
  temperature:
    entity: sensor.xxx        # required
    name: Custom Name         # override display name
    unit: "°C"                # override unit
    setpoint: 25              # ideal value
    min: 10                   # min of the range
    max: 40                   # max of the range
    step: 2                   # threshold step for colors
    icon: mdi:thermometer     # MDI icon
    mode: centric             # centric | heatflow
    availability_entity: binary_sensor.heat_pump  # gray out when off/unavailable

Color modes

In centric mode, the gradient and badge use the same colors — you see at a glance which zone the value is in.

In heatflow mode, the gradient shows the physical temperature scale (cold to hot), while the badge uses green to indicate the value is in the ideal range. Two complementary readings: where on the scale vs is it good.

Multiple sensors of the same type

sensors:
  temperature:
    - entity: sensor.sensor_1
      name: Location 1
    - entity: sensor.sensor_2
      name: Location 2

Languages

12 languages supported: 🇬🇧 English, 🇫🇷 French, 🇩🇪 German, 🇪🇸 Spanish, 🇮🇹 Italian, 🇵🇹 Portuguese, 🇳🇱 Dutch, 🇵🇱 Polish, 🇨🇿 Czech, 🇸🇰 Slovak, 🇮🇱 Hebrew, 🇷🇺 Russian.

Support

Acknowledgments

This card wouldn't be what it is today without our amazing contributors!

• Gregtakacs — Min/Max Tickers and custom bar colors
• Djgel — Specific gravity measurements + Portuguese translation
• JDeighty4 — Magnesium sensor support
• Sebaer1976 — German translation
• Splitti — German translation
• jorgemiguel4 — Portuguese translation
• CosminFRC — Romanian translation
• Misa1515 — Slovak translation
• ViPeR5000 — Polish translation
• Yehuda — Hebrew translation
• MrSnakeSPb — Russian translation
• hlaffez — Tuya BLE-YL01 compatibility
• DAVIZINH0 — Bluerriot compatibility information
• Sangoku — Bromine sensor support
• smashtup — Display precision fix (Entity Registry)
• taczirjak — Hungarian translation
• KIDNORswe — Swedish translation
• FejbyK — Czech translation

Monitor Cards Family

This card is part of the monitor-cards family — same rendering engine, same features, different presets: