If an ESPHome device of yours drives a screen through ili9xxx, st7735, st7789v, qspi_dbi or rpi_dpi_rgb, it now has an end date. On 14 October 2026 J. Nick Koston merged five small pull requests that set ESPHome 2027.5.0 as the version in which these display components will be removed.

What changed

All five components have been deprecated since April 2026, but the warning never said when they would go. Without a date there was no real pressure to migrate, and every change to ESPHome's core still had to keep the old drivers working. The new warnings, shown when ESPHome generates code for a device, now name both the removal version and the replacement:

  • ili9xxx, st7735, st7789v and qspi_dbi point to mipi_spi;
  • rpi_dpi_rgb points to mipi_rgb.

The same version is also written into the DEPRECATED_COMPONENT marker read by ESPHome's pull request bot.

How much time you have

According to the pull requests, the warnings ship in 2026.11, which gives about six months before the drivers disappear in 2027.5.0. Until then existing configurations keep compiling. After that, a device that still uses one of these platforms will not build on a new ESPHome version.

The examples in the pull requests show how ordinary these setups are: a 2.4-inch 320x240 TFT on ili9xxx, a TTGO T-Display (model: TTGO TDisplay 135x240) on st7789v, a 128x160 panel on st7735, an RM690B0 panel on qspi_dbi and an 800x480 parallel RGB panel on rpi_dpi_rgb.

What to do now

Nothing breaks today, so there is no need to rush a migration on a working device. A sensible approach is to note which devices use the old platforms and move them to mipi_spi or mipi_rgb at the next planned update, when the device is within reach and you can look at the screen afterwards. After switching drivers, check colours, orientation and offsets before closing the case. The ESPHome documentation pages for mipi_spi and mipi_rgb describe their options.