Zigbee2MQTT - Tuya Smart Button TS004F (1-Button)

Blueprints Exchange
, ,
1

This is a blueprint for Tuya TS004F 1-Button Smart Switch using Zigbee2MQTT with MQTT Device Triggers.

:iphone: Compatible Models

  • TS004F - Tuya/Moes Smart Button (1-button version)
  • Manufacturers: _TZ3000_ja5osu5g, _TZ3000_kjfzuycl
  • Commercial names:
    • MOES Smart Button (ZT-SY-SR-MS)
    • MOES ERS-10TZBVB-AA
    • Loginovo ZG-101ZL
    • Tuya Wireless Scene Switch (1 button version)

:sparkles: Supported Actions

  • Single press
  • Double press
  • Long press (hold ~2 seconds)

:rocket: Get Started

Click the badge to import this Blueprint:

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

Or manually import using this URL:

https://raw.githubusercontent.com/ferezvi/HA-Blueprints/main/TS004F_1_Button.yaml

:clipboard: How to Use

  1. Import the blueprint using the button above
  2. Press your button at least once (each action type: single, double, long) after pairing it with Zigbee2MQTT - this allows Home Assistant to discover available triggers
  3. Create an automation from the blueprint
  4. Select your button device from the dropdown
  5. Configure actions for each press type
  6. Done! :tada:

:gear: Requirements

  • Home Assistant with Zigbee2MQTT integration
  • TS004F button paired with Zigbee2MQTT
  • Does NOT require legacy entities (future-proof)

:bulb: Features

  • :white_check_mark: Visual device selector (no need to write MQTT topics manually)
  • :white_check_mark: Uses official MQTT Device Triggers (recommended by Zigbee2MQTT)
  • :white_check_mark: No legacy/deprecated features
  • :white_check_mark: Supports multiple button formats (single/1_single, etc.)
  • :white_check_mark: Restart mode for reliable trigger handling

:wrench: Troubleshooting

Button not appearing in selector?

  • Make sure it’s paired with Zigbee2MQTT
  • Press each button action at least once
  • Refresh the automation page

Actions not triggering?

  • Check Zigbee2MQTT logs to see if events are being published
  • Verify the button is sending actions in MQTT
  • Try pressing the button multiple times

:memo: Notes

Based on community blueprints and adapted for single-button TS004F models. Tested and working great - feels even faster than ZHA! :blush:

GitHub Repository: GitHub - ferezvi/HA-Blueprints: Personal Blueprints for Home Assistant

Feel free to report issues or suggest improvements!