Tuya in Home Assistant
tuya
part of Home Assistant since 0.74
Tuya is an official Home Assistant integration for Binary sensor, Camera, Climate, Cover, Doorbell, Event, Fan, Humidifier, Light, Number, Scene, Select, Siren, Switch, Vacuum and Valve. Works through the manufacturer’s cloud; changes arrive straight away, but only while the internet connection and the service are up.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Cloud, push – Works through the manufacturer’s cloud; changes arrive straight away, but only while the internet connection and the service are up.
- Setup
- in the user interface
- Kind
- Hub – several devices through one gateway or account
- Installations
- 159,606 (23.4 % of the installations that share statistics)
- Categories
- Binary sensor, Camera, Climate, Cover, Doorbell, Event, Fan, Humidifier, Light, Number, Scene, Select, Siren, Switch, Vacuum, Valve
- Provides
- Alarm control panel, Binary sensor, Button, Camera, Climate, Cover, Diagnostics, Event, Fan, Humidifier, Light, Number, Scene, Select, Sensor, Siren, Switch, Vacuum, Valve
- Found automatically via
- Network discovery (DHCP)
- Maintained by
- @Tuya, @zlinoliver
- Python packages
tuya-device-handlers==0.0.29, tuya-device-sharing-sdk==0.2.15
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for Tuya.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Known issues and fixes
72 open issues and 30 bug fixes in the last twelve months are recorded for Tuya in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.9.0.
Open
- open The Tuya integration may suddenly stop working due to a network error that prevents proper authentication.
- open Users might encounter a network error that causes authentication failures with the Tuya integration.
- open Devices connected via Tuya may appear as unavailable in Home Assistant.
- open After an update, a Tuya climate device might display an incorrect target temperature of -6.1°C.
- open Updating Home Assistant could lead to unstable control feedback with Tuya devices.
- open The Tuya integration might require reauthentication due to API limits, but reloading the integration can restore the connection without needing reauthentication.
- open A network error can cause the Tuya integration to crash.
- open Support for the Tuya 'tdq' product (a temperature and humidity sensor with an external probe) is missing.
Fixed
- fixed in 2026.9.0 The Tuya integration's translation for an indicator light was missing.
- fixed in 2026.9.0 The Tuya integration incorrectly referred to doorbell payloads as a doorbell.
- fixed in 2026.6.4 A translation for a flow form field in the Tuya integration was missing.
- fixed in 2026.4.3 The dlq ADD_ELE energy sensor in Tuya was missing the kWh unit.
- fixed in 2026.4.1 Energy sensor units in the Tuya integration were not displaying correctly.
- fixed in 2026.2.2 The Tuya integration incorrectly showed devices as unavailable.
- fixed in 2026.2.1 The Tuya climate integration had a redundant 'off' preset option.
- fixed in 2026.1.0 The Tuya light integration had an incorrect color data wrapper.
- fixed in 2025.12.3 Parsing of BitmapTypeInformation in the Tuya integration was incorrect.
- fixed in 2025.12.3 Handling of HVAC modes in the Tuya integration was not optimal.
- fixed in 2025.12.1 Unit parsing for Tuya climate entities was incorrect.
- fixed in 2025.12.0 Bug fix #157473
Source: the issue tracker of Home Assistant, as of September 13, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration