weatheralerts v2026.5.0

[jlverhagen]

Weather Alerts v2026.5.0

Release date: May 6, 2026

---

Important - Read Before Updating

This release does not introduce breaking changes for users upgrading from Weather Alerts v2026.1.0.

If you are upgrading from v2026.1.0, existing Weather Alerts sensors, automations, dashboard cards, and integration options should continue to work.

If you are upgrading from v0.1.5 or earlier, review the v2026.1.0 migration notes before updating because the integration moved from YAML platform configuration to UI-based configuration in v2026.1.0.

---

Breaking Changes and Deprecations

No New Breaking Changes

• No breaking changes are introduced in v2026.5.0.
• YAML platform configuration remains deprecated from v2026.1.0.
• YAML packages remain deprecated and are not maintained.
• Users still relying on old YAML package helpers should plan to migrate to the integration sensor attributes, automation examples, dashboard examples, or the new WeatherAlerts Alert Card.

---

What You Should Do Before Updating

1. Review the WeatherAlerts Alert Card documentation:
   https://github.com/custom-components/weatheralerts/blob/master/documentation/alert_card.md

2. If you are upgrading from a version prior to v2026.1.0, review the migration documentation:
   https://github.com/custom-components/weatheralerts/blob/master/documentation/migration.md

---

Summary of Changes in 2026.5.0

This release adds the new bundled WeatherAlerts Alert Card, improves NWS headline handling, and updates documentation for the new card and fixed NWSheadline and NWSheadlines alert attributes.

The new card provides built-in dashboard display options for active Weather Alerts without requiring users to build complex Lovelace templates manually. The WeatherAlerts Alert Card is a work-in-progress, with more configurability and customization options planned for future releases. Feel free to start a discussion or open an issue on the Github repo with suggestions for this new card.

---

New Features

• WeatherAlerts Alert Card

  • Added a bundled custom dashboard card for displaying Weather Alerts.
  • Supports rotating, ticker, list, and full display modes.
  • Supports automatic severity-based styling for warnings, watches, advisories, other alerts, and no-alert states.
  • Supports configurable headline text source using headline_source.
  • Supports configurable title, subtitle, count badge, update time, alert details, and empty-state display options.
  • Inspired by AlertTicker-Card

• Automatic dashboard resource registration

  • The bundled WeatherAlerts Alert Card resource is automatically registered for Home Assistant storage-mode dashboards.
  • The resource URL includes the integration version for browser cache busting.
  • YAML-mode dashboards still require manual resource configuration.

• Expanded NWS headline data

  • Added NWSheadlines to each alert item.
  • NWSheadline provides the first NWS headline value as a string.
  • NWSheadlines provides the full NWS headline list for users who want access to all returned headline values.

---

Fixes

• Fixed NWSheadline handling so the value is correctly populated from the NWS API parameters.NWSheadline list.
• Added NWSheadlines so future NWS alerts with multiple headline values can expose the full list.
• Some fixes to dashboard examples and automation examples.

Thanks to lmilius for the NWSheadline pull request: #94

---

Documentation

Updated documentation includes:

• WeatherAlerts Alert Card documentation:
  https://github.com/custom-components/weatheralerts/blob/master/documentation/alert_card.md

• Sensor attributes documentation:
  https://github.com/custom-components/weatheralerts/blob/master/documentation/sensor.md

• Automation examples:
  https://github.com/custom-components/weatheralerts/blob/master/documentation/examples_automations.md

• Dashboard examples:
  https://github.com/custom-components/weatheralerts/blob/master/documentation/examples_dashboard.md

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

---

Notes for Existing Users

• Users upgrading from v2026.1.0 should not need to recreate their Weather Alerts configuration.
• After updating, restart Home Assistant.
• Refresh your browser after updating so the new card JavaScript loads correctly.
• Storage-mode dashboards should receive the WeatherAlerts Alert Card resource automatically.
• If the dashboard resource is manually deleted while Home Assistant is still running, restart Home Assistant to allow the integration to register it again.
• YAML-mode dashboards require the card resource to be added manually in YAML.

---

Support

If you encounter issues after upgrading:

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

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

---

This discussion was created from the release weatheralerts v2026.5.0.