Tuya in Home Assistant
tuya
part of Home Assistant since 0.74
The Tuya integration connects Home Assistant to a wide range of smart devices via a cloud-based gateway, allowing users to control and monitor devices through a single account. It supports automation and monitoring for various home systems.
Typical uses
- Controlling smart lights and switches
- Monitoring with cameras and sensors
- Automating scenes and routines
- Managing climate and HVAC systems
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
- 167,555 (23.3 % 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.33, 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
66 open issues and 34 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.10.0.
Open
- open The Tuya integration may suddenly stop working with a message about a network error and invalid authentication.
- open Users encounter a network error message when using the Tuya integration.
- open Tuya devices may appear as unavailable in Home Assistant even though they are functioning.
- open Tuya climate devices show an incorrect target temperature after a Home Assistant update.
- open The Tuya integration displays a network error when trying to use the remote API.
- open Control feedback for Tuya devices becomes unstable after updating Home Assistant.
- open The Tuya integration requires reauthentication after hitting an API limit, disrupting connectivity.
- open Tuya cameras are not supported by the integration and do not work. Affects: Tuya camera
Fixed
- fixed in 2026.10.0 Home Assistant now shows an error when sending commands to Tuya devices fails.
- fixed in 2026.9.4 Tuya fans now correctly turn off when their speed is set to 0%.
- fixed in 2026.9.0 The Tuya indicator light is now properly translated in Home Assistant.
- fixed in 2026.9.0 The Tuya doorbell no longer incorrectly identifies payloads as a doorbell.
- fixed in 2026.6.4 Missing translation for a Tuya flow form field has been added.
- fixed in 2026.4.3 The Tuya energy sensor now correctly displays the kWh unit for electricity usage.
- fixed in 2026.4.1 Tuya energy sensor units are now correctly displayed.
- fixed in 2026.2.2 The Tuya integration no longer shows devices as unavailable when they are not.
- fixed in 2026.2.1 A redundant 'off' preset in Tuya climate devices has been removed.
- fixed in 2026.1.0 Tuya light color data is now correctly wrapped and displayed.
- fixed in 2025.12.3 Parsing of Tuya BitmapTypeInformation is now fixed.
- fixed in 2025.12.3 Handling of Tuya HVAC modes has been improved for better functionality.
Source: the issue tracker of Home Assistant, as of November 1, 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
The description was written by a language model from the facts listed here, not taken from the documentation.