Skip to content

weatheralerts v2026.1.0

Choose a tag to compare

View all tags
@jlverhagen jlverhagen released this 30 Jan 06:58
v2026.1.0
040731a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Weather Alerts v2026.1.0

Release date: January 30, 2026

⚠️ IMPORTANT – READ BEFORE UPDATING ⚠️

This release introduces breaking changes to how the Weather Alerts integration is configured.

If you are upgrading from a previous version, do not update until you have reviewed the information below.

Breaking Changes and Deprecations

UI-Only Configuration

  • YAML-based platform configuration is deprecated and no longer supported for new setups.
  • All configuration is now performed entirely through the Home Assistant UI.
  • Existing YAML-based platform configuration is automatically migrated to UI-based config entries on startup.

No manual migration steps are required, but you should verify your configuration after updating.

YAML Package Deprecation

  • The optional YAML packages provided with earlier versions of this project are now deprecated.
  • These YAML packages were intended as helpers and automations for easy use of the integration, but are not required for the integration to function.
  • YAML packages are no longer maintained and will be removed in a future release.
  • The Automation Examples and Dashboard Examples links will give you what you need to get started replacing the existing persistent notification automation and provide dashboard examples to use the integration sensor data.

If you are currently using a Weather Alerts YAML package:

  • You may continue using it, but review the Installation documentation on how to upgrade and continue using the YAML Package.
  • Review the updated Automation Examples and Dashboard Examples documentation for easy to use examples to help you migrate away from the YAML Package.

What You Should Do Before Updating

  1. Review the updated README:
    https://github.com/custom-components/weatheralerts/blob/master/README.md

  2. Review installation and configuration documentation:
    https://github.com/custom-components/weatheralerts/blob/master/documentation/installation.md
    https://github.com/custom-components/weatheralerts/blob/master/documentation/configuration.md

  3. If you previously used YAML configuration or YAML packages:

    • Allow Home Assistant to start once after updating
    • Confirm the Weather Alerts integration is present and working
    • Remove legacy YAML configuration entries after verification
    • Plan migration away from the YAML Package if still in use

Summary of Changes in 2026.1.0

This release is a major update to the Weather Alerts integration, introducing built-in alert tracking for use with persistent notifications, improved configuration options, expanded documentation, and a fully UI-driven configuration experience.

New Features

  • Persistent alert tracking

    • Alerts are tracked across Home Assistant restarts
    • Each alert includes lifecycle status (new, old, delete)

  • Improved error handling

    • Automatic fallback to last known good data during NWS API outages
    • Structured error history exposed via sensor attributes

  • Configurable update behavior

    • User-configurable sensor update interval
    • User-configurable API timeout with validation safeguards

  • Optional alert deduplication

    • Removes duplicate alerts with identical descriptions when enabled

  • Custom alert icon configuration

    • Per-alert event icon mappings configurable via integration options flow
    • Default fallback icon for unknown event types

  • Expanded zone support

    • Public zones, county zones, and marine zones supported
    • Multiple zone types may be combined into a single sensor

Improvements

  • Sensor state now consistently represents the number of active alerts
  • Alert data is normalized and sorted consistently
  • Expired alerts handled more reliably during API outages
  • Entity naming and unique ID handling standardized
  • Documentation fully rewritten and reorganized

Documentation

Full documentation, examples, and troubleshooting guides:
https://github.com/custom-components/weatheralerts/tree/master/documentation

Notes for Existing Users

  • YAML platform configuration is deprecated
  • YAML packages are deprecated and no longer maintained

Support

If you encounter issues after upgrading:

  1. Review the documentation
  2. Enable debug logging from the Weather Alerts integration page
  3. Reproduce the issue
  4. Open an issue with logs attached

Issue tracker:
https://github.com/custom-components/weatheralerts/issues

Assets 2
Loading
16 Join discussion