Dashboard cards
Start here: a ready-made dashboard
You don't need to build anything by hand. ZoneFlow can make a whole dashboard for you, with an overview tab and one tab per zone. Many people start by adding cards one at a time and only find this later, so it is worth doing first.
- In Home Assistant go to Settings, Dashboards, Add dashboard, and choose New dashboard from scratch.
- Open the new dashboard, open the three dots menu and choose Raw configuration editor.
- Replace everything in the editor with this:
strategy:
type: custom:zoneflow
- Save it.
You get an overview tab and one tab per zone, built from your zones each time the dashboard opens, so a new zone shows up by itself. If you have areas, each area gets a tab with its zones side by side. A greenhouse gets one tab that also lists its crops. After you update ZoneFlow, do a hard refresh of the browser once (Ctrl+F5) so the newest cards load.
The overview card also has a Create a ZoneFlow dashboard button for administrators, which does the same in one click.
The tabs are made from the cards described below. If you would rather lay out your own dashboard, or add a ZoneFlow card to a dashboard you already have, read on. If your dashboard is in YAML mode, see "Dashboards in YAML mode" at the end of this page first.
The cards
ZoneFlow ships its own dashboard cards with the integration. Nothing to install or add as a resource — they show up in the card picker as soon as ZoneFlow is installed.
The zone card
Edit a dashboard, Add card, ZoneFlow zone, and pick the zone. Or in YAML:
type: custom:zoneflow-card
device_id: <the zone's device> # picked for you in the card editor
show_journal: true # Plant journal button
show_settings: true # Settings button: every setting, grouped
show_diagnostics: false # Diagnostics button
simple: false # Simple view: status and a few controls
title: Chili bed # optional: instead of the zone's name
icon: mdi:chili-hot # optional
It shows the zone's Status sentence up top, then the valve, soil moisture and next watering, the controls (water now for the minutes you choose, deep soak now, snooze today, pause, fertilized, mark watered) and service runs. Control buttons run immediately, with no confirmation popup. Only actions that are hard to undo, such as ignoring a setup warning, deleting a zone or dropping a plant onto another zone, ask first. Plants, Settings and the other popups open at the bottom, like Home Assistant's own entity dialogs.
Under the status sentence, Why? shows the numbers behind the next watering. When rain has counted as a watering, its rain line says how much rain was counted and how much of it that watering already used up. Recent activity lists what the zone ran, skipped and stopped in the last 10 days, with the reason and the time of each; it reads Home Assistant's own history of the zone's status, so ZoneFlow stores nothing extra. In the Now section, the technical numbers (litres of the last cycle, the weekly target, the 3-day peak temperature, water used and the growth ramp) sit behind Show details, so the card starts with the valve, the next watering, the soil and the rain. Check my setup is a plain checklist of anything still missing, and Calibrate the flow rate walks you through setting the flow rate. A Where is this? dropdown moves the zone between areas and greenhouses. The Simple view option keeps only the status, Water now, Snooze and Pause, with everything else behind Advanced settings; it is on for newly added cards. The Settings popup opens with the everyday settings, and Show all settings shows the rest. A ? beside every setting and group opens its page on this website. See Areas, plants and presets.
It finds the zone's entities through its device and leaves out whatever the zone doesn't use, so after a ZoneFlow update new features appear on it by themselves. Units follow the zone.
Greenhouse and indoor zones show their climate on the same card: the status line with the inside VPD, misting today and whether ventilation is allowed, the Greenhouse Control switch with the manual controls, and the climate settings in their own groups. A zone with no valve gets a greenhouse icon. The card also shows Manual Rain and Add Manual Rain on outdoor zones without a gauge, Resume Automatic and the Auto Resume settings on greenhouse and indoor zones, Forecast Skip Hit Rate in the diagnostics, and a greenhouse's list of crops.
The card shows the last watering as millimetres and litres, and has a Water use estimate settings group. The litres appear once the zone has a Zone Flow (Configure → Zone flow) or a flow meter. A hand-made dashboard can add these entities in an Entities card, replacing <zone> with the zone's entity prefix:
type: entities
title: Water Use
entities:
- entity: number.<zone>_zone_flow
- entity: sensor.<zone>_last_water_volume
- entity: sensor.<zone>_water_used_past_30_days
- entity: sensor.<zone>_water_used_this_year
A hand-made dashboard can also add the zone's area dropdown, and for each area (an area is a device of its own) its Pause, Snooze Today and water use:
type: entities
title: Backyard
entities:
- entity: select.<zone>_where_is_this
- entity: switch.<area>_pause
- entity: button.<area>_snooze_today
- entity: sensor.<area>_water_used_past_30_days
- entity: sensor.<area>_water_used_this_year
Replace <area> with the area's entity prefix. Plants, History, Check my setup, Calibrate and Why? are buttons on the ZoneFlow card, not entities.
Hovering over a setting's label in Settings shows a short explanation of what it does, translated into your dashboard's language.
The overview card
Add card, ZoneFlow overview. It starts with My Garden, a plain sentence on how the garden is ("Your garden is doing well.", "Watering now: Chilis", "Chilis: needs a look", "Nothing needs water right now. Rain and soil have it covered." or "Watering is paused."), then a summary: what is watering now, the next watering, rain today, zones that need a look and the water used in the last 30 days. Below it, it finds every zone by itself and shows one row each: status, next watering, last watering and a water-now button. Zones are grouped under their area's heading, with the area's Pause and Snooze Today, and a greenhouse with its crops is a group of its own. A plant that is ready to move out of the nursery gets a badge on its row. Click a zone to open its full card right there. Admins get Add zone and Add area buttons. The Move plants button shows each zone's plants as chips you can drag from one zone to another, see Areas, plants and presets.
type: custom:zoneflow-overview-card
sort: next # or name (default): soonest watering on top
title: Garden # optional
icons: # optional, picked per zone in the card editor
<device_id>: mdi:chili-hot
show_add: false # optional: hide the Add zone button
A zone set up with a plant preset gets a matching icon by itself; pick any other in the card editor. Paused zones and ones with no date sort last. On a phone the Last column folds away.
Dashboards in YAML mode
ZoneFlow adds a small loader script to Settings → Dashboards → Resources by itself, so the cards show up even on a dashboard opened while Home Assistant is still starting. If your dashboard is in YAML mode (lovelace: mode: yaml), ZoneFlow can't add that resource for you — add it under lovelace: in configuration.yaml:
lovelace:
resources:
- url: /zoneflow_static/zoneflow-loader.js
type: module
Without it the cards still work, but right after a restart a dashboard may briefly show "Configuration error" until you reload it.