Set Up Tuya Integration (Stable) in Home Assistant

Last Updated on : 2025-03-03 01:40:40download

This topic describes how to install the official Tuya integration for Home Assistant.

Limitations

This integration supports common device categories, such as switches, lights, fans, and thermo-hygrometers. However, it does not guarantee that Home Assistant supports all categories of Tuya devices.

Prerequisites

You have installed the Tuya Smart or Smart Life app, created an account, and added at least one device to that account. For more information, see Smart Life App Overview.

Procedure

Install Home Assistant Core

Install Home Assistant Core v2024.2.0 or later. For more information, see Installation.

Set Up Tuya Integration (Stable) in Home Assistant

Install the Tuya integration for Home Assistant

On Home Assistant, search for and install the Tuya integration.

Enter localhost:8123 in your browser and press Enter.
Create an account and log in.
Choose Settings > Devices & Services.
On the Integrations tab, click ADD INTEGRATION.
Search for Tuya, and click the integration icon to install it.
In the pop-up window, enter your user code.

To get your user code, do the following:
1. Open the Tuya Smart or Smart Life app.
2. Tap Me in the bottom right corner, and tap the settings icon in the top right corner.
3. Choose Account and Security > User Code.
Open the app, tap the + (plus sign) in the top right corner and tap Scan. Scan the QR code and click SUBMIT to log in.
After logging in, you can view and control devices.

FAQs

Which categories does the Tuya integration for Home Assistant support?

The following table displays the categories that the Tuya integration for Home Assistant supports.

Classification	Category code	Category
Large home appliance	kt	Air conditioner
Large home appliance	rs	Water heater
Small home appliance	cwwsq	Pet feeder
	qn	Heating device
	sd	Robot vacuum
	fs	Fan
	cl	Curtain motor
	kj	Air purifier
	cs	Dehumidifier
	xxj	Aroma diffuser
	mc	Door/Window controller
	cwysj	Pet water dispenser
Electrical device	kg	Switch
	cz	Socket
	pc	Power strip
	clkg	Curtain switch
	jdcljqr	Curtain robot
	wk	Thermostat
	dlq	Circuit breaker
	ckmkzq	Garage door opener
	fskg	Fan switch
Security and sensor	wsdcg	Temperature and humidity sensor
	mcs	Door/Window sensor
	ywbj	Smoke detector
	rqbj	Gas detector
	pir	Passive infrared sensor
	sj	Water detector
	pm25	PM2.5 sensor
	hps	Human presence sensor
	sos	Emergency button
	ldcg	Luminance sensor
	sp	Pan-tilt camera
	sgbj	Audible and visible alarm
	zd	Vibration sensor
	co2bj	CO2 sensor
	cobj	CO sensor
	jqbj	Formaldehyde detector
	jwbj	Methane detector
	voc	Volatile organic compound sensor
	ylcg	Pressure sensor
	mal	Alarm host
	dgnbj	Multifunctional sensor
	hjjcy	Environmental sensor
	zndb	Smart electricity meter
Lighting device	dj	Light
	dd	Strip light
	fwl	Ambient light
	dc	String light
	xdd	Ceiling light
	fsd	Ceiling fan light
	fwd	Ambient light
	gyd	Motion sensor light
	jsq	Humidifier
	tgkg	Dimmer switch
	tgq	Dimmer
	tyndj	Solar light
	ykq	Remote control
Kitchen appliance	bh	Smart electric tea kettle
	kfj	Coffee maker
	mzj	Sous vide cooker
	cn	Formula milk maker

How to use the new version of the Tuya integration with existing devices?

If you are currently using an older version of the integration and have authorized some devices, and you are considering using the new integration, you will need to install the new integration and reauthorize both your new and existing devices. Please note that there is no upgrade path between the old version of the integration and the new version.

Prev DocConfigure Smart Home PaaS

Next DocUse Tuya Homebridge Plugin