Shelly · Button Series

SHBTN-2

Active

Shelly Button 1 WiFi Smart Button

Shelly Button Series Introduced circa 2020

Shelly Button 1 — WiFi smart button with local API.

Common Applications

The most hackable commercial smart button. Runs on ESP8266 internally — can be flashed with Tasmota or ESPHome via OTA (no soldering). But even stock firmware has a local HTTP API and MQTT support. No cloud required for basic operation. Press events (single, double, triple, long) trigger webhooks, MQTT messages, or Shelly scenes. The reference for what a smart button should be.

Openness & Hackability

Fully Open

Custom firmware: Stock (local HTTP API + MQTT), Tasmota, ESPHome (OTA flashable)

Best-in-class openness. Stock firmware includes local HTTP REST API, MQTT client, and CoAP — all work without internet. OTA flashable to Tasmota or ESPHome with zero soldering. Home Assistant auto-discovers Shelly devices. The gold standard for hackable smart buttons.

Repair & Maintenance

Rechargeable battery accessed by prying open the case with a plastic spudger. Battery is a small LiPo pouch cell. The ESP8266 chip is accessible for serial flashing if OTA fails. Reset by holding the button for 10 seconds during power-up.

Specifications

Battery Life
6 months typical
Battery Type
Rechargeable (USB-C)
Color
White
Smart Home Integrations
Shelly Cloud (optional), Home Assistant, MQTT, HTTP API, Alexa, Google Home
IP Rating
IP54
Protocol
WiFi 2.4GHz

Installation Quick Reference

Setup: Pair with your hub or phone via WiFi 2.4GHz. Most smart buttons support single press, double press, and long press for three different actions.

Battery: Uses Rechargeable (USB-C) battery. Expected life: 6 months typical. Low battery notification via the app.

Dimensions

Troubleshooting

Not responding to input

Check wiring continuity with a multimeter. Verify the contact block is properly seated. Inspect terminals for loose connections.

Where to Buy

Price range

$91.65 — $171.6

across 2 distributors

Quick Specs

Battery Life
6 months typical
Battery Type
Rechargeable (USB-C)
Color
White
Smart Home Integrations
Shelly Cloud (optional), Home Assistant, MQTT, HTTP API, Alexa, Google Home
IP Rating
IP54

What People Are Saying

+

“Best-in-class openness. Stock firmware includes local HTTP REST API, MQTT client, and CoAP — all work without internet. OTA flashable to Tasmota or ESPHome with zero soldering. Home Assistant auto-dis”

Reddit r/homeassistant 25 upvotes View thread →