Short version: The Tuya Zigbee Wireless Door Window Sensor is a small device that tells Home Assistant if a door or window is open or closed. It connects using Zigbee, a common wireless standard for smart home devices, which means it works locally without needing the internet or a separate Tuya app after setup. The main catch is making sure you buy the correct Zigbee version, as many similar sensors from Tuya also come in Wi-Fi versions that work differently.
Updated November 2026.
What the Tuya Zigbee door sensor is
The Tuya Zigbee door sensor is a simple smart home device. It has two parts: a main sensor and a smaller magnet. You mount the main sensor on your door or window frame, and the magnet on the moving part of the door or window itself. When the door or window opens, the magnet moves away from the sensor. This breaks a connection, and the sensor immediately sends a signal to your smart home system, like Home Assistant, to say the door is now open. When the door closes, the magnet returns, and the sensor sends a signal that the door is closed.
The listing says this sensor is very small, often around 40-50mm long, which helps it blend in with your home decor. It runs on a small battery, typically a CR2032 coin cell, which means you do not need to wire it to mains power. The battery life is usually stated to be several months to a year, but this can vary a lot depending on how often the door or window opens and closes. The sensor communicates using Zigbee, a low-power wireless technology that creates a mesh network. This means each Zigbee device can pass signals to other Zigbee devices, extending the range of your smart home network.
Home Assistant compatibility
This Tuya Zigbee door sensor is designed to work well with Home Assistant, especially through its Zigbee connection. Because it uses Zigbee, it can connect directly to your Home Assistant setup if you have a Zigbee coordinator, which is a USB stick or device that lets Home Assistant talk to Zigbee devices. This allows for local control, meaning your sensor works even if your internet goes down.
| Option | Works? | Notes |
|---|---|---|
| ZHA | Yes | ZHA, or Zigbee Home Automation, is Home Assistant’s built-in Zigbee integration. It should support this standard Zigbee sensor. |
| Zigbee2MQTT | Yes | Zigbee2MQTT is another popular way to connect Zigbee devices to Home Assistant. This model is known to be supported. |
| Tuya (cloud integration) | Yes | If you buy a Tuya-branded Zigbee sensor, it will likely appear in the Tuya cloud app. The Home Assistant Tuya integration can then pull its status from the cloud. However, this is not a local control path for Zigbee devices. |
| Matter | No | Matter is a newer smart home standard. Zigbee devices are not directly compatible with Matter without a bridge. |
| Local or cloud | Local | When connected via ZHA or Zigbee2MQTT, the sensor operates locally. If used with the Tuya cloud integration, it relies on the internet. |
Who it is for
This Tuya Zigbee door sensor is a good choice for Home Assistant users who already have a Zigbee network set up with a coordinator. It is ideal if you need a simple, affordable way to monitor the open/closed status of doors, windows, cabinets, or even drawers. Its small size makes it discreet, and its local control capability means it will still work for automations even without an internet connection. If you are looking to build basic security alerts or trigger lights when a door opens, this sensor fits the bill without breaking the bank.
However, this sensor is not for everyone. You should skip this if you do not have a Zigbee coordinator and are not planning to get one, as it will not connect directly to Home Assistant otherwise. If you need advanced features like vibration detection, tamper alerts, or temperature sensing in a single device, you might need to look at more feature-rich or specialized sensors. Also, if you prefer Wi-Fi devices because you do not want to manage a separate Zigbee network, this Zigbee-only sensor is not the right choice for you.
How to set it up in Home Assistant
Setting up the Tuya Zigbee door sensor in Home Assistant is straightforward if you are using a Zigbee integration like ZHA. Here are the steps:
- First, make sure your Zigbee coordinator is properly set up and working with your Home Assistant instance. This is a USB stick or other device that allows Home Assistant to communicate with Zigbee devices.
- In Home Assistant, go to Settings, then click on Devices & services.
- Find your Zigbee integration (ZHA or Zigbee2MQTT) and click on Configure.
- Look for an option like Add device or Permit join. This puts your Zigbee network into pairing mode, allowing new devices to connect.
- Now, put your Tuya Zigbee door sensor into pairing mode. The listing typically explains how to do this. It usually involves pressing and holding a small button on the sensor for a few seconds until an indicator light starts flashing.
- Home Assistant should detect the new sensor. Once it appears, you can name it and assign it to a room.
- After pairing, you will see a new entity in Home Assistant, usually a binary sensor that shows its state as ‘on’ (open) or ‘off’ (closed). You can then use this entity in your automations.
Common issues and variants to avoid
- Zigbee vs. Wi-Fi versions: This is the most common issue with Tuya products. Many AliExpress listings for door sensors look identical but offer both Zigbee and Wi-Fi versions. Always double-check the product title, description, and especially the variant selector before buying to ensure you are getting the Zigbee model. Wi-Fi versions require the Tuya cloud app and integration, which is not local control.
- Generic Tuya branding: Sometimes, these sensors are sold with very generic branding. While many work fine, some generic Tuya Zigbee devices might have slightly different firmware or chipsets that could cause minor pairing difficulties or unexpected behavior with ZHA. Zigbee2MQTT often has better support for a wider range of Tuya variants.
- Battery life expectations: While manufacturers often claim long battery life, real-world usage can vary greatly. Frequent opening and closing of a door will drain the battery faster. Be prepared to replace the CR2032 battery every 6-12 months, depending on use.
- Zigbee mesh network: For reliable performance, your Zigbee mesh network needs to be strong. If the sensor is far from your Zigbee coordinator or other always-on Zigbee devices (like smart plugs or light bulbs that act as repeaters), you might experience dropped signals or slow response times. Consider adding Zigbee repeaters if you have range issues.
- Model number verification: If you encounter pairing issues, check the specific model number printed on the device or its packaging. Then, consult the Zigbee2MQTT supported devices list to see if your exact model is listed and if there are any specific pairing instructions or known quirks.
Should you buy it?
The Tuya Zigbee Wireless Door Window Sensor is a solid choice if you are looking for an inexpensive, reliable way to add basic door and window monitoring to your Home Assistant setup. Its Zigbee connectivity ensures local control, which is a major benefit for smart home enthusiasts who prioritize privacy and offline functionality. Just be very careful to select the Zigbee version from the listing, as Wi-Fi variants are common and will not offer the same local control benefits.
If you already have a robust Zigbee network, this sensor offers good value. However, if you do not have a Zigbee coordinator yet, you will need to invest in one, which adds to the initial cost. For those seeking more advanced features like vibration sensing or a more robust build, you might consider alternatives like the SONOFF SNZB-04P R2 Zigbee door sensor, which is another popular option in the Home Assistant community.
Frequently Asked Questions
Does the Tuya Zigbee door sensor work with Home Assistant without the cloud?
Yes, if you connect the Tuya Zigbee door sensor through a Zigbee integration like ZHA or Zigbee2MQTT, it will communicate directly with Home Assistant. This means it operates locally and does not rely on the internet or the Tuya cloud for its basic functions.
Do I need a hub for the Tuya Zigbee door sensor?
Yes, you need a Zigbee coordinator, often called a Zigbee hub or stick, to connect this sensor to Home Assistant. This device allows Home Assistant to create and manage your Zigbee network, enabling communication with the sensor.
How can I tell if I am buying the Zigbee or Wi-Fi version of the Tuya door sensor?
Always check the product title, description, and especially the variant options on the AliExpress listing. Look for keywords like ‘Zigbee’ or ‘ZIGBEE’ in the product name or selection. If it only mentions ‘Smart Life’ or ‘Tuya App’ without ‘Zigbee’, it is likely a Wi-Fi version.