Skip to content
tempus2016 edited this page Nov 9, 2026 · 2 revisions

The Health Card and Badge (v2.9.0+)

Dashboard health in the editors says what is wrong with a dashboard's templates, but only once you open an editor to look. The health card puts the same findings on the dashboard itself: every card pointing at a template that is not there, leaving a variable unset, or using a deprecated template, with an Open button that takes you to it.

The health card: 1 template missing, 2 variables unset, 1 deprecated in use and 6 cards fine, then one line per card with an Open button, and Open the full panel at the foot

type: custom:decluttering-card-plus-health-card

In the add-card dialog it is Decluttering Card Plus: health. Across the top it counts each kind of problem and the cards that have none, then lists the first few cards with something to look at, each with what it is called, the dashboard and view it is on, and what is wrong. The foot says how many warnings the cards on this page gave while they were building, and Open the full panel shows the whole health panel in a dialog, with the statistics and those warnings in it.

A card is called by its name:, or else by the first of its values that reads like a name (name, area, entity and so on), or else by its template.


As a badge

The health badge: an amber exclamation mark, 4 to look at, Templates

The same type in a view's badges is the summary: how many cards need a look, or All fine. Clicking it opens the full panel.

badges:
  - type: custom:decluttering-card-plus-health-card
    hide_when_clean: true

With hide_when_clean: true it takes itself away while there is nothing to look at, and gives its place in the row back. In edit mode it always shows, so it can still be edited. It is in the add-badge dialog too, under the same name.


Options

Option Default What it does
dashboards this all checks every dashboard as well, one after another; an entry on another dashboard says which, and Open goes there
show all three Which kinds to list: missing, unset, deprecated. A list, or one line separated by commas. The counts at the top always cover all three
limit 5 How many entries the card lists
hide_when_clean false Take the card or badge away while there is nothing to look at
title Template health The card's heading
type: custom:decluttering-card-plus-health-card
title: Templates on every dashboard
dashboards: all
show: missing, unset
limit: 10

Open

Open is only there for an administrator. On a card in the view you are looking at, it opens that card's editor. Anything else, a card in another view, a badge, or a card on another dashboard, opens that view in edit mode, since Home Assistant only opens an editor for a card in the view on screen. A card inside a stack opens the stack.


When it checks

The checks run when the card loads and again whenever the dashboard is saved, never on a state change, so a health card costs nothing while the house is busy.

A variable a repeat supplies to each copy (entity, index, an area's items and the rest) is never counted as unset, and neither is one a view strategy hands down to its sections. A template borrowed from another dashboard counts as there. (v2.10.0+) A card that fills a template's slot through slots: has set it: before v2.10.0 the card and the badge listed every such card as leaving that variable unset.

What the cards said while building is about this page load rather than the dashboard's configuration, so it is only counted at the foot and listed in the full panel: a placeholder refused, a state read without rebuild_on, a deprecated template built.


→ Visual Editors · Cards · Badges

Clone this wiki locally