RingBuffer has moved from esphome/core/ring_buffer.h into a new ring_buffer helper component at esphome/components/ring_buffer/ring_buffer.h under the esphome::ring_buffer namespace. The old location is deprecated and will be removed in ESPHome 2026.11.0.
This is a breaking change for external components in ESPHome 2026.5.0 and later.
Virtual handler interfaces (GAPEventHandler, GAPScanEventHandler, GATTcEventHandler, GATTsEventHandler, BLEStatusEventHandler) have been replaced with callback-based dispatch. External components that inherit from these interfaces must update their registration approach.
This is a developer breaking change for external components in ESPHome 2026.4.0 and later.
CallbackManager and LazyCallbackManager now use a lightweight 8-byte Callback struct instead of std::function (16 bytes). External components that define their own callback registration methods using std::function should update to templates for optimal performance.
This is a breaking change for external components in ESPHome 2026.4.0 and later.
Custom mode vectors (custom_fan_modes, custom_presets for climate; preset_modes for fan) are now stored on the entity base class instead of being rebuilt inside traits on every call. The old ClimateTraits and FanTraits setter methods are deprecated.
This is a breaking change for external components in ESPHome 2026.4.0 and later.
The FlushResult enum introduced in ESPHome 2026.3.0 has been renamed to UARTFlushResult with prefixed enum values to follow ESPHome’s naming conventions and avoid macro collisions.
This is a breaking change for external components in ESPHome 2026.4.0 and later.
Copyright © 2026 ESPHome - A project from the Open Home Foundation
