Release history
esphome releases
ESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.
All releases
27 shown
2026.4.5
Bug fix
Notable features
- Opt-in toggle for ESPHome Device Builder in HA add-on
Full changelog
- [ha-addon] Add opt-in toggle for the new ESPHome Device Builder esphome#16247 by @jesserockz
- [bundle] Include secrets.yaml when
!secretkeys are quoted esphome#16271 by @bdraco - [substitutions] Fix sibling references inside dict-valued substitutions esphome#16273 by @bdraco
- [core] Fix WiFi connection in safe mode esphome#16269 by @Mat931
- [nextion] Fix text sensor state not updated on string response esphome#16280 by @edwardtfn
2026.4.4
Bug fix
Fixed codegen type for component.resume update_interval.
Full changelog
- [automation] Fix codegen type for component.resume update_interval esphome#16069 by @bharvey88
- [mcp23xxx_base] Reject unsupported interrupt_pin options (inverted, allow_other_uses) esphome#16149 by @bdraco
- [core] Strip \?\ prefix from sys.executable for PlatformIO subprocess esphome#16158 by @jesserockz
- [esp32] Replace 512B stack buffer in printf wraps with picolibc cookie FILE esphome#16170 by @bdraco
- [lvgl] Clamp values for meter line indicators esphome#16180 by @clydebarrow
- [esp32] Drop printf wrap on IDF 6.0+ (picolibc no longer needs it) esphome#16189 by @bdraco
- [api] Fall back to owning types for service array args used after a delay esphome#16140 by @bdraco
- [api] Use safe_print for log output and fix safe_print bytes-repr fallback esphome#16160 by @jesserockz
2026.4.3
Bug fix
Minor fixes and improvements.
Full changelog
- [lvgl] Triggers on tabview tabs fix esphome#15935 by @clydebarrow
- [time] Handle Windows EINVAL when validating POSIX TZ strings esphome#15934 by @jesserockz
- [deep_sleep] Fix sleep_duration codegen type to uint32_t esphome#15965 by @bdraco
- [wifi] Fix stale wifi.connected after state transition esphome#15966 by @bdraco
- [rotary_encoder][at581x] Fix templatable int field types esphome#16015 by @bdraco
- [esp32][wifi] Fix bootloop and WiFi connection issue if nvs partition is missing or has non-default label esphome#16025 by @Mat931
- [nextion] Unify TFT upload ack timeout to 5000ms esphome#15960 by @edwardtfn
- [esp32_touch] Feed wdt esphome#16066 by @jesserockz
- [image] Fix RGB565+alpha rendering for multi-frame animations esphome#16017 by @bdraco
2026.4.2
New feature
Notable features
- ESP32 Secure Boot V1 ECDSA signing scheme
Full changelog
- [lvgl] Fix format of hello world page esphome#15868 by @clydebarrow
- [lvgl] Fix overloads for setting images on styles esphome#15864 by @clydebarrow
- [lvgl] Fix update of textarea attached to keyboard esphome#15866 by @clydebarrow
- [image] Fix rodata bloat for multi-frame RGB565+alpha animations esphome#15873 by @swoboda1337
- [core] Fix Pvariable placement new losing subclass identity esphome#15881 by @swoboda1337
- [ld2412] Fix null deref in set_basic_config when entities unconfigured esphome#15893 by @swoboda1337
- [esp32] Add Secure Boot V1 ECDSA signing scheme for pre-rev-3.0 ESP32 esphome#15882 by @kbx81 (new-feature)
- [io_expanders] Self-heal interrupt-driven expanders when INT stays asserted across the read esphome#15923 by @swoboda1337
- [usb_uart] Derive TX output chunk count from
buffer_sizeconfig esphome#15909 by @kbx81
2026.4.1
New feature
Notable features
- Track main loop active time and report overhead in runtime_stats
Full changelog
- [core] Fix app_state_ status bits clobbered for non-looping components esphome#15658 by @bdraco
- [core] Inline feed_wdt hot path with out-of-line slow path esphome#15656 by @bdraco
- [st7789v] Fix swapped offset_width/offset_height in model presets esphome#15755 by @swoboda1337
- [sx126x][sx127x] Fix frequency precision loss from float32 codegen esphome#15753 by @swoboda1337
- Bump aioesphomeapi from 44.15.0 to 44.16.0 esphome#15757 by @dependabot[bot]
- [lvgl] Clean the build if lv_conf.h changes esphome#15777 by @clydebarrow
- [mitsubishi_cn105] use HEAT_COOL mode to enable temperature slider esphome#15748 by @crnjan
- [core] Diagnose missing cg.templatable in codegen for TEMPLATABLE_VALUE fields esphome#15758 by @bdraco
- [time] Fix RTC is_valid() rejecting valid times after day_of_year cleanup esphome#15763 by @bdraco
- [qmc5883l] Move per-update log line from DEBUG to VERBOSE esphome#15781 by @swoboda1337
- [bundle] Force-resolve nested IncludeFile during file discovery esphome#15762 by @bdraco
- [ili9xxx] Guard against null buffer in display_() when allocation fails esphome#15786 by @bdraco
- [esp32] Accept unquoted minimum_chip_revision values esphome#15785 by @swoboda1337
- [lvgl] Guard lv_image_set_src wrapper with LV_USE_IMAGE esphome#15789 by @swoboda1337
- [runtime_stats] Track main loop active time and report overhead esphome#15743 by @bdraco (new-feature)
- [mipi_spi] Drawing fixes for native display esphome#15802 by @clydebarrow
- [image] Fix byte order handling esphome#15800 by @clydebarrow
- [core] coerce set_interval(0) / update_interval: 0ms to 1ms esphome#15799 by @bdraco
- [ethernet] Fix SPI3_HOST default breaking compile on variants without SPI3 esphome#15809 by @swoboda1337
- [core] Fix DelayAction compile error with non-const reference args esphome#15814 by @bdraco
- [esp32] Downgrade unneeded
ignore_pin_validation_errorto a warning esphome#15811 by @swoboda1337 - [runtime_image] Fix RGB order esphome#15813 by @clydebarrow
- [lvgl] Fix crash with snow on rotated display esphome#15822 by @clydebarrow
- [core] Feed WDT unconditionally in main loop to fix empty-config panic esphome#15830 by @bdraco
- Bump aioesphomeapi from 44.16.0 to 44.16.1 esphome#15836 by @dependabot[bot]
- [core] Default PollingComponent() to 1ms when codegen is bypassed esphome#15831 by @bdraco
- [substitutions] Fix
substitutions: !include file.yamlregression esphome#15850 by @bdraco - [packages] Improve error messages with include stack and fix missing path propagation esphome#15844 by @jpeletier
- [lvgl] Fix angles for arc esphome#15860 by @clydebarrow
2026.3.3
Bug fix
Fixed queue age calculation in Nextion drivers to handle mixed timestamps, cleared LVGL image data on size changes, and made ESP32 builds re-run when SDK config changes, improving stability and build consistency.
2026.3.2
Bug fix
Fixed WiFi roaming issues, UART/SPI corruption, datetime handling, sensor offsets, thermostat logic; added ESP8266 scanf_float option with additional component fixes.
2026.3.1
Breaking risk
Breaking changes
- ESP8266 power_save_mode mapping corrected (LIGHT/HIGH values were swapped)
2026.2.3
Breaking risk
Breaking changes
- Removed broken ESP8266 ssl_fingerprints option for MQTT
2026.2.2
Maintenance
Fixed compilation errors, API issues, sensor configuration, speaker playback across DSMR, BME68X, water heaters, PID, and audio components.
2026.2.1
Bug fix
Fixed critical socket/connection issues, BLE characteristic handling, ESP32 variant compilation, and numerous component-specific bugs including WiFi and UART fixes.
2026.1.5
Maintenance
Fixed NRF52 logging, LVGL crashes, WebSocket cleanup, AQI calculation, and cache directory handling with component capacity validation.
2026.1.4
Maintenance
Fixed HTTP request timeouts, WiFi condition checks, power reading stalls, IPv6 warnings, and added missing API overloads for improved reliability.
2026.1.3
Bug fix
Fixed WiFi scan panics on ESP8266, chunked transfer encoding response handling, and OTA error messaging. Updated webserver assets.
2026.1.2
Bug fix
Fixed deprecation warnings across display and PWM components, increased I2C transaction timeout, resolved WiFi scan watchdog timeouts and race conditions. Enhanced st7701s display initialization.
2026.1.1
Bug fix
Fixed critical WiFi and HTTP request issues including SSL verification failures on ESP32, WiFi manual IP preventing API connections, and OTA failures. Improved memory allocation and sensor delay handling.
2025.12.7
Security relevant
Security fixes
- Buffer overflow in i2s_audio software volume control
2025.12.6
Bug fix
Fixed ESP-NOW channel validation, device class issues in sensors, packet size checking, and OTA backend abort handling. Added conditional entity type guards.
2025.12.5
Mixed
Notable features
- ESP32 BLE no longer requires network configuration
- CC1101 PLL lock verification and retry support
Full changelog
- [lvgl] Fix arc background angles esphome#12773 by @clydebarrow
- [sn74hc595]: fix 'Attempted read from write-only channel' when using esp-idf framework esphome#12801 by @aanikei
- [wts01] Fix negative values for WTS01 sensor esphome#12835 by @cnrd
- [esp32_ble] Remove requirement for configured network esphome#12891 by @clydebarrow
- [cc1101] Add PLL lock verification and retry support esphome#13006 by @swoboda1337