Short version: The Tuya Zigbee Door Window Entry Sensor is a small device that tells you if a door or window is open or closed. It works well with Home Assistant through a Zigbee coordinator, using either ZHA or Zigbee2MQTT. The main catch is making sure you buy the correct Zigbee version, as some listings offer Wi-Fi models that only work with the Tuya cloud.
Updated November 2026.
What the Tuya Zigbee Door Window Entry Sensor is
This sensor is a simple smart home device designed to detect when a door, window, or even a drawer is opened or closed. It comes in two parts: a main sensor and a smaller magnet. You mount the main sensor on the frame and the magnet on the moving part. When the magnet moves away from the main sensor, the sensor reports that the contact is open. When they come back together, it reports closed.
The listing says this sensor uses Zigbee, which is a low-power wireless communication standard for smart home devices, similar to Wi-Fi but designed for smaller, battery-powered gadgets. It typically runs on a CR2032 coin cell battery, which is usually included. The listing does not specify battery life, but these sensors often last for many months or even a year before needing a new battery.
Home Assistant compatibility
This Tuya Zigbee door sensor is designed to work with Home Assistant, but you will need a Zigbee coordinator. A Zigbee coordinator is a USB stick or other device that plugs into your Home Assistant server and lets it talk to Zigbee devices.
| Option | Works? | Notes |
|---|---|---|
| ZHA | Yes | Pairs directly with Home Assistant’s built-in Zigbee Home Automation (ZHA) integration. |
| Zigbee2MQTT | Yes | Supported by Zigbee2MQTT, a separate program that handles Zigbee communication for Home Assistant, often offering wider device support. |
| Tuya (cloud integration) | Likely | If you use the Tuya Smart Life app first, you can link it to Home Assistant via the Tuya cloud integration. This is not local control. |
| Matter | No | This is a Zigbee device, not a Matter device. Matter is a newer smart home standard. |
| Local or cloud | Local | Works locally with ZHA or Zigbee2MQTT. Cloud control is possible if used with the Tuya app and cloud integration. |
Who it is for
This Tuya Zigbee door sensor is a good choice for Home Assistant beginners who already have a Zigbee network set up. If you have a Zigbee coordinator and want to add simple, reliable sensors for security alerts, lighting automation, or to check if a door is left open, this sensor is a solid, inexpensive option. It is great for those who want local control, meaning your smart home works even if your internet goes down.
You should skip this sensor if you do not have a Zigbee coordinator or do not plan to get one. If you only use Wi-Fi devices, or if you are looking for devices that support the newer Matter standard, this sensor will not fit your needs. Also, if you prefer not to deal with potentially confusing product listings that mix Zigbee and Wi-Fi versions, you might want to consider other options.
How to set it up in Home Assistant
Setting up this Zigbee door sensor in Home Assistant usually involves pairing it with your Zigbee coordinator. Here are the general steps for both ZHA and Zigbee2MQTT:
- First, make sure your Zigbee coordinator is properly set up in Home Assistant, either with the ZHA integration or Zigbee2MQTT.
- Open Home Assistant and go to Settings, then Devices & services.
- For ZHA: Click Add integration, then search for and select Zigbee Home Automation if it is not already set up. If it is, click Configure on your ZHA integration, then Add device.
- For Zigbee2MQTT: Go to the Zigbee2MQTT web interface. You can usually find a link to it in the Home Assistant sidebar or under the Zigbee2MQTT add-on settings. Once in Zigbee2MQTT, click Permit join (All).
- On the sensor itself, you will need to put it into pairing mode. This usually involves pressing and holding a small button on the sensor for 5-10 seconds until an LED light starts blinking. If the sensor has a battery tab, pull it out to activate the battery.
- Once the sensor is in pairing mode, your Home Assistant (through ZHA or Zigbee2MQTT) should detect it. Follow any on-screen prompts to finish adding the device.
- After pairing, the sensor will appear in Home Assistant as a new entity, typically showing its open/closed state and battery level.
Common issues and variants to avoid
- Zigbee vs. Wi-Fi versions: Many AliExpress listings for door sensors, including this one, offer both Zigbee and Wi-Fi versions. Always double-check the product variant or description before buying to ensure you select the Zigbee model. The Wi-Fi versions usually require the Tuya Smart Life app and rely on the cloud.
- Pairing problems: If the sensor does not pair, try moving it closer to your Zigbee coordinator or a Zigbee router (a powered Zigbee device that extends your network). Make sure the battery is inserted correctly and fully charged. Sometimes, performing a factory reset on the sensor (often by holding the pairing button for a longer time, like 10-15 seconds) can help.
- Battery life: While these sensors are low-power, actual battery life can vary. Frequent opening and closing of the door or window will cause the sensor to report more often, using more battery. Low temperatures can also reduce battery performance.
- Mixed listings and model numbers: Some sellers might ship different models even if the listing looks the same. Always check the model number on the box or device itself if you encounter unexpected behavior. The Zigbee2MQTT supported devices list can be a good place to verify specific model compatibility.
- Range and mesh network: Zigbee devices rely on a mesh network. If your sensor is far from your coordinator or other powered Zigbee devices, it might have connection issues. Consider adding more Zigbee router devices, like smart plugs or light bulbs, to improve your Zigbee mesh tips.
Should you buy it?
For Home Assistant users with an existing Zigbee network, the Tuya Zigbee Door Window Entry Sensor is a very affordable and effective way to add basic open/closed detection. It integrates locally with both ZHA and Zigbee2MQTT, giving you full control without relying on cloud services. Just be careful to select the correct Zigbee version when purchasing.
If you are looking for a simple, budget-friendly sensor to kickstart your home automation or enhance your security, this sensor is a good choice. For alternatives, consider other Tuya-branded Zigbee door sensors or the SONOFF SNZB-04P for a similar local control experience, though prices may vary.
Frequently Asked Questions
Does the Tuya Zigbee Door Window Sensor work with Home Assistant without the cloud?
Yes, this sensor can work directly with Home Assistant using a Zigbee coordinator and either the ZHA or Zigbee2MQTT integration. This setup allows for full local control, meaning it does not need an internet connection to function once paired.
Do I need a hub for the Tuya Zigbee Door Window Sensor?
Yes, you need a Zigbee coordinator, which acts as a hub for your Zigbee network. This is a small USB stick or device that plugs into your Home Assistant server and allows it to communicate with Zigbee devices like this sensor.
Should I get the Zigbee or Wi-Fi version of the Tuya door sensor?
For Home Assistant users, the Zigbee version is almost always preferred. It offers local control, is generally more reliable for sensors, and uses less battery. The Wi-Fi version typically requires the Tuya Smart Life app and relies on cloud services, which means it will not work if your internet is down.