How to Migrate to Tuya v2

Last Updated on : 2022-04-14 03:27:52download

Regarding the installation of the new Tuya Home Assistant integration, we provide two options for different situations. The first option is to delete the old Tuya Home Assistant integration and migrate to the new version. The second option is to install the new version and keep the old version as it is, because the old and new versions can coexist. This topic describes how to migrate to the new version from the old version.


We always strive to provide the best development experience possible and keep updating our Home Assistant integration capabilities. Since the old version of Tuya Home Assistant integration supports limited categories and control commands, now we bring you our new integration with extended support for more categories and commands.

Our new integration is built on Tuya’s standard APIs and tackles the limits of categories and accessible control commands. We deliver more development-friendly features including virtual device debugging, official authorization, and technical supports, which will help you efficiently work on development with the Tuya ecosystem.

The following table lists the differences between the old and new version:

Items Old integration New integration
Supported category Since the old interface only applies to voice control scenarios and six types of Tuya’s devices, the control commands and device types are obviously limited. Built on Tuya’s standard OpenAPI, the new integration supports devices of all types and most of the control commands.
Note: It supports all the devices that are controlled based on cloud-to-cloud connectivity. For more information, see Standard Instruction Set.
Driver development Supports real device testing only. Supports option for testing virtual devices, which improves the efficiency of debugging drivers for different categories.
Verification method Not supports official verification. Supports Tuya official secure authorization and verification to protect your account from intrusion.
Technical support No Tuya official support provided. Supports Tuya official technical support and integration iteration. If you have any problems, submit a service ticket to request support.
Operation on Tuya IoT Platform No operation is needed on the Tuya IoT Platform. Create a cloud project of Smart Home PaaS on the Tuya IoT Platform.
Installation Official installation method of Home Assistant. Two options: copy method and HACS installation
Integration initialization Requires four items of information: Account of Tuya IoT Platform, Account Password, Country Code, and Mobile App. Requires seven items of information: Region, Access ID, Access Secret, Mobile App, Country Code, App Account, and App Account Password.
Note: Regarding the Mobile App, you must select the one you used to link devices on the Tuya IoT Platform.
App Supports Tuya Smart, Smart Life, and Jinvoo Smart. Supports Tuya Smart and Smart Life currently. To request support for OEM apps, submit a service ticket and let us know.
Response speed Second Millisecond

Things to note

  • If you have never created a cloud project of Smart Home type on the Tuya IoT Platform, you can create one directly. For more information, see Create cloud project.

  • If you have created a cloud project of Smart Home type before May 25, 2021, you need to unlink devices in your old project and then go through the Link Devices process for your new project. For more information, see Migrate from old project.


Note: During migration, the automation setup of the old Tuya Home Assistant Integration cannot run on the Home Assistant.

Operation on the Tuya IoT Platform

Create cloud project
Before installation, you need to create a cloud project of Smart Home type on the Tuya IoT Platform. For more information about project creation, see Tuya IoT Platform Configuration Guide Using Smart Home PaaS.

Migrate from old project (for project of Smart Home PaaS type created before May 25, 2021)

  1. Log in to the Tuya IoT Platform.

  2. In the navigation pane on the left, click Cloud > Development. Select your project of Smart Home type.
    How to Migrate to Tuya v2

  3. Click Devices > Link Tuya App Account and unlink the app.
    How to Migrate to Tuya v2

  4. Create a new cloud project of Smart Home type. For more information about the procedure, see Tuya IoT Platform Configuration Guide Using Smart Home PaaS.

  5. In your new project, click Devices > Link Tuya App Account. Click Add App Account and scan the QR code with the Tuya Smart or Smart Life app.
    How to Migrate to Tuya v2

    How to Migrate to Tuya v2

(Optional) Delete the old version

  1. Log in to the Home Assistant.
  2. Select Configuration > Integrations.
  3. On the Integrations tab, select > Delete.
    How to Migrate to Tuya v2

Install the new integration

For more information about installing new integration, see How to Use Tuya Home Assistant Integration.