Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Repair Windows errors before they cause bigger problems3Scan for outdated or missing drivers - takes under a minuteYes—Home Assistant can connect to many devices configured through the Tuya Smart or Smart Life apps. On Home Assistant OS, formerly called Hass.io, the official Tuya integration is installed from Settings → Devices & services; it is not normally a separate add-on or HACS package.
The important limitation is that the official integration is cloud-based. It can be easy to set up, but it may have latency, requires Tuya cloud connectivity, and may not expose every control available in the mobile app.
As an Amazon Associate I earn from qualifying purchases.
Does Tuya work with Home Assistant?
The official Tuya integration supports many devices added to Tuya Smart and Smart Life. This includes products sold under the Tuya name, rebranded products, and devices marketed as Powered by Tuya.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Compatibility is not completely uniform. Tuya is an ecosystem used by many manufacturers, rather than one standardized hardware range. Two smart plugs, lights, thermostats, or vacuums may expose different functions because of their product definitions, firmware, regional services, or manufacturer-specific data points.
#1 Best Overall
- [Multi-Protocol Hub with Matter Bridge] The M is a versatile hub supporting Tuya/Smart life Zigbee,Bluetooth,Thread devices. Supports advanced Matter bridge functionality, enabling Tuya-exclusive scenes and signals to sync with Matter ecosystems such as Home Assistant for seamless integration.
- [Upgrade your Tuya Hub] Improve connective stability,Control of Matter,BLE or ZigBee devices:the user can control the Matter,BLE or ZigBee sub-devices through the gateway to support remote control.Supports up to 128 Tuya Zigbee devices （Not third-party Zigbee devices) and 128 Thread devices (Repeaters are needed)，200 Bluetooth devices.（Not third-party Zigbee devices)
- Matter:Standard Matter gateway,which supports OTBR,support access to standard matter over thread devices,Have both bridge,controller and border router roles.CSA Certifited. And you can add these devices into Apple Home,Home Assistant or smartthings through the gateway.
- Support wired and wireless WiFi networking and WiFi supports both 2.4G and 5G,It supports the communication protocols of Cable+WiFi+Zigbee+Bluetooth+Thread, that is, the uplink Ethernet and wireless WiFi connect to the cloud, and the downlink supports Zigbee (compatible with Tuya’s original Zigbee device ecosystem), Bluetooth (compatible with Tuya’s original Bluetooth device ecosystem) and Thread (Matter over thread) sub-devices.
- Local scenario/automation:when the scenario /automation execution is preferentially local.Through this function,the intelligent scenario/automation set by the user can beexecuted efficiently when the network is broken.
The most useful initial test is whether the device can be added to Tuya Smart or Smart Life and controlled there. That confirms that the device belongs to a supported app ecosystem, but it does not guarantee that every mobile-app feature will appear in Home Assistant.
What you need before setup
- A working Home Assistant installation, including Home Assistant OS if that is your preferred installation type.
- The Tuya Smart or Smart Life mobile app.
- A Tuya or Smart Life account.
- At least one device already paired with that account.
- A second screen, such as a phone, tablet, or another computer, for displaying Home Assistant’s QR code.
- Access to your Home Assistant instance through its browser interface.
First confirm that the device works in the mobile app and is assigned to the correct home or location. Home Assistant must authenticate against the same app account that contains the device.
How to install the official Tuya integration
1. Find your Tuya User Code
In the Tuya Smart or Smart Life app, use the current documented path:
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →- Open the app and select Me.
- Tap the gear icon in the upper-right corner.
- Open Account and Security.
- Find User Code at the bottom of the page.
Copy the User Code carefully. It is not your email address, phone number, password, device ID, or Tuya IoT Platform access key. App labels can change between versions and regions.
2. Add Tuya in Home Assistant
- Open Home Assistant.
- Go to Settings → Devices & services.
- Select Add Integration.
- Search for Tuya.
- Follow the displayed instructions.
Home Assistant may discover Tuya automatically. If Tuya appears under discovered integrations, select it there instead of adding it manually.
3. Authorize Home Assistant with the QR code
During setup, Home Assistant displays a QR code. On your phone:
- Open Tuya Smart or Smart Life.
- Tap + or Add Device.
- Choose Scan, or open the app’s QR-code scanner.
- Scan the QR code shown by Home Assistant.
- Complete the authorization prompts.
After authorization, inspect Settings → Devices & services, open the Tuya integration, and check that the expected devices and entities are present. Test a basic action, such as switching a light or plug on and off.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Rank #2
- 【Dual Mode Gateway Hub】NOTE: The ZigBee Hub isn't compatible with Blind, Sengled Bulb and Door Lock. It’s a ZigBee and Bluetooth dual mode gateway hub. With ZigBee 3.0 and Bluetooth 5.0, you can use it to connect most of the ZigBee and Bluetooth smart devices. NOTE: The ZigBee Hub is only compatible with Tuya Smart devices, It means your smart devices is compatible with Smart Life App or Tuya Smart Life App. Please confirm it before purchase.
- 【APP Remote Control】The wireless smart hub is compatible with Smart Life and Tuya Smart App. When it connects with your 2.4GHz WiFi, you can control your smart devices anywhere and anytime you want.
- 【Easy To Set Up】You can connect the ZigBee Hub with the video. No need to connect to network cable, just need insert the smart gateway hub cable into power and connect it with the Smart Life app. Within few second pairing, you can add your home bluetooth and zigbee devices and enjoy smart home automation.
- 【Stable and Reliable Connection】The Smart ZigBee gateway connection works stably, with wide coverage, strong reception signal, low power consumption, and the Type-C can keep working when it is powered on.
- 【Which kind of Products Can be Connected】The dual mode ZigBee and Bluetooth gateway is only compatible with those sub-devices who use Tuya protocols. The ZigBee gateway is not compatible with any other products who use other platform protocols! Please make sure your devices is compatible with Tuya protocols first.
Do you need a Tuya IoT Developer account?
For the current built-in Home Assistant setup, ordinary users generally follow the QR-code and app-account flow above. The current Home Assistant documentation does not make creating a Tuya IoT cloud project part of the normal consumer setup.
Older tutorials can be confusing because earlier or developer-oriented workflows instructed users to create a Tuya IoT Platform account, create a cloud project, select a data center, authorize APIs, and link the mobile-app account. Tuya’s legacy documentation still describes that process at GitHub.
Do not create a developer project merely because an old video shows one. Follow the screens in your current Home Assistant version. Developer-platform instructions may still be relevant to developers, installers, commercial integrators, or specific legacy tools, but they are not automatically the correct setup for the built-in integration.
Adding devices after the initial setup
Pair new devices in Tuya Smart or Smart Life first. They may not appear in Home Assistant immediately. Reload the integration:
- Go to Settings → Devices & services.
- Find Tuya.
- Open its three-dot menu.
- Select Reload.
If reloading does not refresh the device list, restart Home Assistant and check the integration again.
Which Tuya devices and entities are supported?
Home Assistant lists support for many platform types, including:
- Binary sensors and cameras
- Climate devices and humidifiers
- Covers, fans, lights, switches, and valves
- Doorbells, events, numbers, selects, sirens, and scenes
- Vacuums
The official integration does not support every Home Assistant platform; the documentation specifically excludes the lock and remote platforms. Even within a supported category, the exact entities depend on the device’s firmware and the controls exposed by Tuya’s product definition.
Rank #3
- 【2 Modes in 1 Gateway】Support MOES/Tuya Bluetooth mesh (SIG) + Zigbee3.0 multi-protocol communication. Only one gateway is needed to connect devices of different protocols to the 2.4Ghz network.
- 【Support 128 Devices】 Support up to 128 Tuya smart home devices, such as Bluetooth Door Lock, ZigBee Light Switch No Neutral, Bluetooth Finger, Zigbee Power Monitor Plug, Bluetooth Thermometer, ZigBee Window Gate Sensor, etc.
- 【Sound & Light Alarm】 Support sound and light alarm.Support Local Scenario / Support Local Automation / Support Security Function and be integrated into the Tuya Security Saas Platform.
- 【Voice & App Remote Control】 No matter where you are, you can control the connected smart devices through the MOES/Smart Life App on your mobile phone. Support voice control of Alexa, and Google Assistant.
- 【ESAY SET-UP】Designed for quick and easy set-up with absolutely no wiring or technical skills required.Quickly and easily add, reset, and group devices via the hub.
A device appearing in Home Assistant means only that some usable data or control has been exposed. It does not mean that every mode, schedule, energy statistic, alarm, preset, or diagnostic value from the mobile app will be available.
Why are controls or sensors missing?
Home Assistant says that incomplete functionality is often caused by limitations in Tuya’s official Python SDK. It is therefore possible for a device to pair successfully while exposing only a switch, a basic light control, or a limited set of sensors.
For a device with missing controls, download diagnostics:
- Open Settings → Devices & services.
- Open the Tuya integration.
- Select the affected device.
- Open the three-dot menu.
- Select Download diagnostics.
- Examine the
status,status_range, andfunctionkeys.
If all three are empty, the Home Assistant documentation says that only Tuya scenes, if any, may be available. Review diagnostic files before sharing them publicly; they may contain device, account, network, or location information.
Tuya scenes in Home Assistant
Scenes created in the Tuya app can appear in Home Assistant after the integration updates. A Tuya scene is not necessarily the same as a native Home Assistant automation: it remains a Tuya-defined action and may depend on Tuya’s cloud service.
Scenes can be useful when the individual device controls are incomplete. For example, a complex appliance mode may be available as a Tuya scene even when Home Assistant cannot expose every underlying setting. Test important scenes during a controlled internet outage before relying on them for time-sensitive or safety-sensitive automations.
Official Tuya integration versus Tuya Local
| Consideration | Official Tuya | Tuya Local |
|---|---|---|
| Setup | Simple, built into Home Assistant | More technical and device-specific |
| Normal control path | Tuya cloud | Local network communication |
| Internet outage | Home Assistant control may fail | May continue working on the LAN |
| Compatibility | Broad, but limited by the official SDK | Varies by model, firmware, keys, and data points |
| Maintenance | Official Home Assistant integration | Separate third-party project |
| Privacy | Uses Tuya’s cloud services | Reduces normal cloud control, but does not necessarily stop all vendor communication |
Tuya Local is a separate custom integration. It may offer lower latency, more local operation, or additional controls, but it can require local keys, device-specific configuration, network discovery, and troubleshooting. A device can work with the official integration and fail with Tuya Local, or the reverse.
Rank #4
- 2 MODES IN 1 GATEWAY: This Smart home hub support Bluetooth mesh (SIG) + Zigbee3.0 multi-protocol communication. Only one gateway is needed to connect devices of different protocols to the 2.4Ghz network.
- APP REMOTE CONTROL: Smart Bluetooth Zigbee hub works with smart life/Tuya App, Support Adding devices, device reset, third-party control and group control. You can manage and remotely control the device through the Smart Life App. You can manage and remotely control your lights, fingerbot and other smart devices via the app, even when you're not home.
- VOICE CONTROL: The smart hub Support voice control, Simply give a voice command to Alexa or Google home to control devices(such as turn on/off the smart plug, turn on/off the Finger Bot).
- SMART HOME AUTOMATION: Sub-devices of the gateway act as trigger conditions for Interacting with devices such as ZigBee, Bluetooth, Wi-Fi, for device linkage. Featured as one powerful network bridge for whole house linkage in a real sense for all smart home devices.
- SUPPORT 128 DEVICES: Support up to 128 Tuya smart home devices, such as ZigBee Motion Sensor, Leak Detector, BLE Finger Bot, Zigbee Door Sensor, BLE Thermometer, ZigBee Window Gate Sensor, etc. NOTE: Supports Tuya/SmartLife devices only.
Choose the official integration when ease of setup and broad compatibility matter more than local control. Investigate Tuya Local for the exact model when privacy, responsiveness, or operation during some internet outages is important.
Local alternatives for new devices
If cloud independence is a priority, consider devices that support:
Recommended Free Tools
- Matter over Wi-Fi or Thread
- Zigbee with a compatible coordinator
- Z-Wave
- ESPHome or Tasmota
- Another documented local Home Assistant integration
Hardware such as Home Assistant Connect ZBT-2 can support Zigbee and Thread/Matter setups, but it does not convert an arbitrary Wi-Fi Tuya device into a local Zigbee or Matter device. The product must actually support the relevant protocol.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Troubleshooting Tuya in Home Assistant
The device works in Tuya but is missing in Home Assistant
- Confirm that it is in the same Tuya or Smart Life account authorized in Home Assistant.
- Check that it is in the correct home or location.
- Reload the Tuya integration.
- Restart Home Assistant if necessary.
- Reconfigure or re-authenticate the integration if authorization has expired.
- Check whether the device category is supported.
- Consider whether the manufacturer’s rebrand exposes restricted cloud data.
The device appears but controls are missing
Check the diagnostics fields described above. Missing controls may reflect an SDK or product-definition limitation rather than a failed installation. Search for support for the exact model, not merely the brand or general product category.
Home Assistant repeatedly asks for authentication
Home Assistant documents a failure mode associated with updated Tuya terms and conditions. If this matches your situation, sign in to iot.tuya.com, accept any updated terms, restart Home Assistant, and reconfigure the integration. Menu names and policy prompts can change.
Region or country mismatch
Region problems are especially relevant to older developer-project setups. Tuya’s legacy guidance says that the cloud project’s data center must serve the region associated with the mobile-app account. The app region can be found under Me → Settings → Account and Security → Region in the documented flow. A mismatch can prevent a linked cloud project from seeing devices.
Updates are delayed or commands are slow
The official integration is identified as Cloud Push, so state updates and commands depend on Tuya’s service, account authorization, network connection, and the device’s own cloud behavior. This is expected behavior for a cloud integration, not evidence that Home Assistant OS itself is malfunctioning.
Best Value
- SMART HOME COMPATIBILITY: Works seamlessly with Alexa and Google Home for convenient voice control of your motorized shades.
- TUYA APP CONTROL: Manage and automate your motorized shades remotely from anywhere using the Tuya smart app on your smartphone.
- HOME AUTOMATION HUB: Acts as a central controller, connecting and coordinating multiple motorized shades for a unified smart home experience.
- EASY INTEGRATION: Designed to connect effortlessly with a wide range of compatible motorized shade devices for a streamlined setup.
- AUTOMATED SCHEDULING: Program custom schedules and routines for your motorized shades to enhance comfort and convenience in your home.
Will it work without internet?
Do not assume so. A device may remain connected to your local Wi-Fi while Home Assistant still needs Tuya’s cloud for authentication, state updates, or commands. To test, disconnect the WAN while keeping the LAN active and try one non-critical light or switch. Restore connectivity before testing appliances, heating, locks, or other safety-sensitive equipment.
Should you buy Tuya devices for Home Assistant?
For devices you already own, trying the official integration is sensible because setup is relatively simple and the device may be usable immediately. For new purchases, choose based on the exact model and the functions you need—not on the Tuya brand alone.
Before buying, ask:
- Does the exact model support Matter, Zigbee, Z-Wave, or a documented local API?
- Is local operation explicitly documented?
- Does it require a vendor cloud account?
- Does Home Assistant support the exact model rather than only the brand?
- Are power, dimming, energy monitoring, temperature, modes, schedules, and alarms all exposed?
- What happens if the vendor cloud is unavailable?
- Does the manufacturer have a credible firmware and app-support history?
For a beginner who needs a Home Assistant host, Home Assistant Green is an optional appliance-like choice; it is not required for Tuya integration. Likewise, Home Assistant Cloud can provide optional hosted services such as remote access and voice-assistant connectivity, but it does not turn the official Tuya integration into local control.
Free tools Windows power users keep installed
One-click scans. No signup required.
For critical functions, avoid relying on a device that is unsupported, cloud-dependent, or missing essential controls. A better-supported local device can be a more dependable long-term choice than a cheaper product requiring a fragile workaround.
Conclusion
The official Tuya integration is the easiest current route for bringing Tuya Smart and Smart Life devices into Home Assistant. Install it through Settings → Devices & services, authorize it by scanning Home Assistant’s QR code with the mobile app, and reload the integration when adding devices later.
Its trade-off is clear: this is cloud-based control with device- and feature-level limitations. Use it when that dependency is acceptable, investigate Tuya Local for a specific compatible model when local operation matters, and favor Matter, Zigbee, Z-Wave, ESPHome, Tasmota, or another documented local option when buying new hardware.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
