How to Set Up Tuya on Home Assistant

In this tutorial, we go through the steps of setting up Tuya devices on Home Assistant using the built-in integration.

Home Assistant Tuya

Tuya is a brand of IoT (Internet of Things) devices commonly used in smart homes. These devices include smart plugs, lights, thermostats, appliances, and more. There are many branded goods that use the Tuya platform, for example, Grid Connect.

Integrating your Tuya devices into Home Assistant, allows you to display their status on dashboards. You can also control the device using automations, toggles, Node-Red, and more. Home Assistant allows for much better control and integration than the default Tuya app.

This tutorial will cover retrieving the user code and using it to integrate Tuya into Home Assistant. We will also look at basic configurations, such as enabling sensor data. It’s important to note that the method described in this tutorial relies on access to the Tuya cloud.

If you prefer to keep things local, take a look at localtuya. Adding your devices is slightly more complicated, but you can control devices locally rather than via the cloud. It is important to note that localtuya may only work with some Tuya devices.

Setting up the Official Tuya Integration

Setting up Tuya is relatively simple, thanks to the built-in integration. As I mentioned earlier, this integration relies on the Cloud. If you prefer, you can look into localtuya which uses a local connection to control a device rather than via the Cloud.

Accessing the Required Data in the Tuya App

1. To begin, you must open the Tuya application on your phone. You will need to download it and add your Tuya devices if you haven’t already done so.

2. First, tap on the Me tab in the bottom right corner.

Tuya App Me Tab Location

3. Within the Me tab, click the cog-like icon in the top right corner.

Tuya App Me Tab Cog Location

4. You should now be on the Settings page. On this page, find and tap on the Account and Security option.

Tuya App Account and Security

5. On the Account and Security page, you should see a section called User Code. Copy the code next to this section for use in a later step.

Tuya App User Code

Configuring Home Assistant

6. In Home Assistant, click the Settings (1) menu item and select Devices & Services (2).

Home Assistant Settings - Devices and Services

7. Click Add Integration in the bottom right corner of the Integrations page.

Home Assistant Integrations - Add Integration

8. In the pop-up box, search for Tuya (1) or scroll until you find it. Next, click on the Tuya option (2).

Add Tuya Integration

9. You must now enter the code (1) that we copied earlier in this tutorial. Once entered, click on Submit (2).

Tuya Enter the User Code

10. A QR code will appear on the screen. You must scan this code within the Tuya app, the next few steps will show you how to do this.

Tuya QR Code

11. In the Tuya app on your phone, click the plus (1) button in the top right corner of the home page. Next, tap on the scan (2) option.

Tuya App - Click on Plus and Scan

12. You should see a prompt requesting you to confirm that you want to log in to Home Assistant. Tap the Confirm Login button to link your Tuya account to Home Assistant.

Tuya App Click on Confirm Login

13. If successful, you will now see all the devices from your Tuya account added to Home Assistant. You can take your time to assign these to specific areas (1), or you can click Finish (2).

Devices Successfully Added

14. To see all your devices, scroll down to the Tuya integration on the integrations page and click the devices link.

Click on the Devices under Tuya on the Integrations Page

15. You should now see all the Tuya devices added to Home Assistant. Click on one to bring up more information on that device.

List of all the Tuya Devices

Enabling Sensor Data

16. On this page you can see all the details about the Tuya device. However, you may notice some data is not being stored. To view these sensors, click on the entities not shown link.

Tuya Device Information

17. Click on one of the sensors to bring up more information. In this example, we will click on the current sensor.

Tuya Devices Disabled Sensors Location

18. Within the pop-up, click on the cog icon in the top right corner.

Click on the Cog inside the entity state history page

19. You should see a message at the top of the pop-up stating that the entity is disabled. Click on Enable to enable the sensor.

Enable Tuya Current Data

You should see a message like the one below appear. Click on OK.

Enabled Entities Message

20. You should now start to see data appear in the user interface next to the sensor that has been enabled.

Tuya Device Sensor now Providing Data


You should now have access to your Tuya devices within Home Assistant. I recommend adding the devices to a dashboard so you can monitor and control them. You can also use automations to control the devices.

If you want to build out your Home Assistant with more integrations and features, check out our other Home Assistant tutorials. We are constantly working on more, so I recommend checking back later.

Please let us know if you have any feedback, questions, or anything else.

Leave a Reply

Your email address will not be published. Required fields are marked *