ESPHome 2026.5.2 released on 02-06-2026
ESPHome 2026.5.2 is out now. Device builders and maintainers benefit from toolchain-clean builds, improved crash decoding for ESP32 IDF builds, and several stability fixes that reduce flaky behaviour.
See the release notes on the ESPHome GitHub repository for full details, download links and the individual pull requests referenced in this release.
What’s in this release
- Clean builds are now triggered when the toolchain changes to avoid stale artifacts.
- ESP32 IDF builds can decode crash program counters via the IDF toolchain so crash reports and backtraces are readable.
- Core storage and API changes: esphome.area is persisted in StorageJSON so area assignments survive restarts and backups; storage_should_clean is exposed as a public API and a crash loop related to VoiceAssistantConfigurationRequest has been fixed.
Upgrade notes
- No breaking changes or deprecations are listed for this release; if you rely on device-builder workflows, check the storage_should_clean API change in the linked PRs before upgrading.
- If you encounter issues after upgrading, roll back to the previous release and report the problem on the ESPHome GitHub issues page with logs and reproduction steps.
Share your experience after upgrading — whether it fixed a long-standing build problem or introduced something unexpected — on the ESPHome GitHub or community channels.
