Update notifications for Home Assistant

auanasgheps · June 15, 2026, 3:42pm

Changelog

Version 2.2.1

Bug Fixes

Fixed: Android notifications may be delayed due to sleep inactivity (Doze) The blueprint now uses high priority settings to allow consistent and on-time delivery on Android. This replicates what the original v1 blueprint did.

Version 2.2

New Features

Lazy mode: A new mode in the Schedule section. When enabled, the Reminder interval is ignored and a single reminder is sent once per week on a configured weekday and time. Ideal if you prefer to handle updates on your own schedule without repeated reminders.
- Note: the Notify after / Notify before time window still applies.
Disabled option for Reminder interval: The “None” interval has been re-introduced. When selected, no hourly reminders are sent. Intended for use together with Lazy mode.
- Note: if both are off, no notifications will be sent.

Version 2.1.1

Bug Fixes

Fixed: reminder notifications not delivered on Android: The stale-notification cleanup loop ran on every reminder trigger, sending one clear_notification FCM call per completed update. With a large number of installed updates this exceeded FCM’s 240 messages/minute per-device limit, causing to drop notifications. The cleanup loop now skips the reminder trigger: it was never needed there, as real-time cleanup is already handled by other triggers.

Version 2.1

New Features

Configuration sections: The configuration is now organised into sections - Schedule, Notifications, and Behaviour - making setup easier to navigate.
Exclude entities: New optional input to permanently silence notifications for specific updates. Useful for integrations that release very frequently, like ESPHome.
Clearer entity selection label: The “Update entities” field has been renamed to “Real-time monitoring for dashboard installs” and moved to the Behaviour section. An improved description clarifies that regular notifications work for all updates automatically. This field only affects dashboard-initiated installs.
- Home Assistant Core is pre-selected: The Core update entity is now pre-selected when setting up the automation, reducing the initial configuration effort.
Exclude auto-updating Apps: New toggle (default: on) to suppress notifications for Apps (Add-ons) that have automatic updates enabled in their settings. These update themselves without user action, so the notification is redundant.
Notification persists after tapping Changelog: iOS does not support sticky notifications like Android, so tapping the Changelog action would previously remove the notification. The Changelog button now re-sends the notification immediately after tapping, restoring the same experience on iOS. Note: if you tap Changelog on the re-sent notification a second time, iOS will suppress the subsequent banner (same notification ID); it will reappear on the next scheduled reminder.

Changes

Reminder interval is now required: The “None” option has been removed. The reminder is the primary notification mechanism, so an interval must always be set. Default is 6 hours; options are 1 / 3 / 6 / 12 / 24.
Improved labels and descriptions throughout for clarity.

Bug Fixes

iOS install/skip buttons now work correctly (replaces the 2.0.1 fix): iOS does not echo action_data back in notification action events, so the previous fix that read the tag from action_data still failed. The tag is now encoded directly in the action string (install-update--<tag>, skip-update--<tag>), making it recoverable on both platforms without any platform-specific logic.
Removed dead iOS triggers: install_ios skip_ios sticky_ios were never used. iOS now sends action: like Android. All three removed.
Early-exit guard: The automation now exits immediately when triggered by an unrelated notification tap (e.g. from another automation), preventing the full cleanup loop from running unnecessarily.
Tapping Update/Skip on a stale notification now clears it correctly: If an update was already applied (e.g. via the dashboard) while the notification was still on the device, tapping Update or Skip now dismisses the notification and stops cleanly instead of failing silently.
iOS notification preview no longer shows a broken attachment error: On long press, iOS was trying to download the entity icon as a rich attachment and failing with a 404 for internal paths. The image field is now only set when the icon URL is externally reachable (http). Internal paths still show correctly as the small notification icon.
Double-tap race condition on Install: Tapping “Update” twice in quick succession no longer causes an error. A guard condition now checks that the update entity is still available and not already in progress before doing anything, so the second tap exits cleanly instead of sending a stuck “Updating…” notification or throwing “No update available” in HA Core logs.
Skip did not clear the notification: Tapping “Skip” left the notification on the device until the next cleanup run. The Skip branch now immediately sends clear_notification (and dismisses the HA persistent notification if enabled).
“Updating…” notification was dismissible on tap-to-install: When installing from the mobile notification, the “Updating…” message was sent without sticky: true, making it dismissible during the update. It now matches the dashboard-install path and stays pinned until cleared.
Startup cleanup covers all entities: On HA restart, stale notifications are now correctly cleared for all completed updates, not just Core and OS.
Completed updates always cleared: Stale notifications for completed updates are now cleared on every automation run, not just on HA restart. This covers updates installed from the HA dashboard for entities not in the real-time monitoring list.
Reminder no longer fires needlessly: The reminder trigger now respects the exclude list - if all pending updates are excluded, the trigger correctly evaluates to false instead of firing and doing nothing.
Skip action YAML fix: The Skip sequence was using an implicit mapping form instead of the correct list-item syntax, which relied on HA’s lenient parser.
second == 0 removed: the reminder now fires reliably at any second within the matching minute, instead of requiring an exact second match that HA’s template engine could easily miss.
“Updating…” notification now works correctly on iOS: When tapping Install, the iOS notification previously had no tap URL and was placed outside the configured notification group. It now navigates correctly on tap and respects the channel grouping.
“Updating…” notification from dashboard installs fixed on iOS: The notification shown when an update starts from the HA dashboard (real-time monitoring) was sending Android-specific fields to iOS devices. It now uses the correct platform-specific payload.
Skip now clears the notification before calling the service: Previously, if the skip service call failed (e.g. entity temporarily unavailable), the notification was left on the device with active buttons. The notification is now dismissed before the service call.

Version 2.0.1

Bug Fixes

iOS install/skip buttons now work: Tapping the Update or Skip button on iOS now correctly recovers the entity tag from the notification. Previously, iOS did not echo back the notification data on regular button taps (only on URI/Changelog actions), causing an action_data undefined error and no update being installed.

Version 2.0

Enhancements & Modernisation

Live Notification updates: The “Updating…” visual feedback and automatic notification dismissal now work for all updates, bypassing the previous limitation that required entities to be manually listed in the blueprint inputs.
Changelog for Home Assistant Apps (Add-ons): since Apps do not provide a changelog URL, the Blueprint will point to the “Info” section of the App, which will show a changelog
Improved UX for Custom Changelogs: Rewrote the description for changelog_urls, added an example directly inside the blueprint UI to easily guide the configuration.
Relative Path Support for Icons: Expanded the image processing logic to natively accept local/relative paths (such as /api/hassio/addons/...). This fixes missing icons while ensuring seamless handling
Modern Home Assistant Compatibility: Fully migrated the blueprint to use modern core standards, updating deprecated service: definitions to the current action: syntax.

Cleanups & Deprecations

Removed Configuration Check: stripped out the run_config_check option, triggers, and corresponding sequence blocks, as the old “Check Home Assistant configuration” add-on is now fully deprecated.
Removed Release Summary: Removed the code that would display the Release Summary, as this is not supported anymore, being replaced by Changelog URL.
Dead Code Elimination: Streamlined the Update completed and startup sequences by removing complex nested YAML anchors and conditional structures left behind by the deprecated features.

Bug Fixes

Resolved Device Notification Crashes: Fixed Error sending notification failures caused by strict Firebase Cloud Messaging (FCM) API serialization constraints. Removed incompatible iOS-exclusive flags on Android targets and added rigorous input validation to omit empty string payloads.
Fixed Template Type-Casting Bugs: Corrected a structural issue where multiline string operators (>-) inadvertently coerced data blocks into plain strings, causing loops to break with extra keys not allowed messages. Reminders are now handled cleanly via native Python types and a strictly anchored id: reminder template trigger.