Repository navigation
Understanding the interface
What each tab, and the update-detail dialog, actually show you.
Each row's trailing badge:
| Badge | Section | Meaning |
|---|---|---|
![]() |
Postponed |
Its own wait period hasn't ended yet (or "very soon" with no time shown). No auto-install set up, so it'll still need a manual click once ready. |
![]() |
Postponed |
Blocked until Home Assistant itself reaches that version. |
| No badge | Ready to update |
Nothing scheduled: click Install yourself. |
![]() |
Ready to update or Postponed
|
Will auto-install at that time (cancellable). Under Postponed, that time is only a forecast, the wait period itself hasn't ended yet. |
![]() |
Ready to update |
Home Assistant's own per-entity "Auto update" is managing this one. |
| A spinner or progress ring | Installing |
Right now. |
An entity on the always-exclude list still goes through the same Postponed wait as any other, "Always manual" only changes whether it auto-installs once ready, not whether it waits first.
A second, separate pill can sit right next to that one, whenever anyone has already voted on this exact version jump:
| Badge | Meaning |
|---|---|
![]() |
This many healthy votes, no problematic ones reported. |
![]() |
This many problematic votes. Shown instead of the healthy count whenever there's at least one, even if healthy votes also exist, see Discouraged below. |
The row's own status text underneath adds the rest: Discouraged means a problematic community verdict is holding it back; Skipped means you used Home Assistant's own "Skip this version" on it. A line ending in "⋅ Always manual" means this entity is on the always-exclude list, see Settings reference.
Clicking an entity opens a dialog with a visual timeline of that one update's lifecycle, roughly top to bottom:
- Update available: the version jump and its size, plus any community-vote info and report controls. Skipped as its own step (folded into the next one) when there was no wait at all, e.g. a small update with no wait days configured.
- Ready to update: shown dimmed while still waiting (with a "Force ready" shortcut), or as Skipped instead if you've used Home Assistant's own "Skip this version" on it (with an "Undo skip" action).
- One of:
- Postponed: this release needs a newer Home Assistant than you're running; shows your current version next to the required one.
- Managed by Home Assistant: its own per-entity "Auto update" toggle is on, so Update Manager steps back entirely.
- Auto-install: a scheduled time (cancellable), or a warning that it's held back by the community verdict for now.
- Installing: only shown while genuinely queued behind Zigbee pacing or the safe install order (see Known limitations), with its own Cancel action.
The dialog's own "Open update" button opens Home Assistant's native update dialog for the actual install click; it doesn't install anything itself.
Entries are grouped into Today, Yesterday, This week, This month, and Earlier. A download-icon badge
(
) on an entry means it auto-installed; opening the
entry shows why: your own size/wait rules, a trusted voter's vote, or the always-auto-install list. No
badge means it was installed manually, or Update Manager couldn't confirm how; opening the entry's own
"Install method" row shows which, when it's actually known.
Covered on its own page: Settings reference.





