Shelly in Home Assistant
shelly
part of Home Assistant since 0.115
The Shelly integration connects Home Assistant with Shelly smart home devices, enabling control and monitoring of various functions. It supports a wide range of device types, including lights, sensors, and climate controls. Typical use cases include automating home lighting, monitoring environmental conditions, and managing energy usage.
Typical uses
- Controlling smart lights
- Monitoring temperature and humidity
- Automating climate systems
- Tracking energy consumption
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, push – Talks to the device on your own network and is told about every change straight away.
- Setup
- in the user interface
- Kind
- Single device
- Quality scale
- Platinum – The highest level: fully typed, efficient and maintained to every rule of the project.
- Installations
- 143,986 (20.1 % of the installations that share statistics)
- Categories
- Binary sensor, Camera, Climate, Cover, Energy, Event, Light, Media player, Number, Select, Sensor, Switch, Text, Update, Valve
- Provides
- Binary sensor, Button, Camera, Climate, Cover, Diagnostics, Event, Light, Media player, Number, Select, Sensor, Switch, Text, Update, Valve
- Found automatically via
- Network discovery (Zeroconf), Bluetooth
- Maintained by
- @bieniu, @thecode, @chemelli74, @bdraco
- Python packages
aioshelly==14.0.1
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for Shelly.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Blueprints that use this integration
- Automation Shelly switch events – Handles events from Shelly switches, requiring the Shelly integration.
- Automation Shelly Button1 press – Triggers actions when a Shelly Button1 is pressed, using binary sensor input.
- Automation Shelly Detached Input - Single Button v1.3.1 – Triggers light and switch actions from Shelly button presses.
- Automation Shelly Plus 1 Button actions – Automates actions based on Shelly Plus 1 Button presses. Requires Shelly integration.
Known issues and fixes
22 open issues and 53 bug fixes in the last twelve months are recorded for Shelly in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.11.0.
Open
- open Users experience intermittent connection problems and error messages when using Shelly devices.
- open Home Assistant fails to retrieve data from Shelly devices consistently.
- open Shelly devices frequently drop and reconnect to Home Assistant every three minutes.
- open The Shelly 2PM Gen3 cover does not allow setting position when first added. Affects: Shelly 2PM Gen3
- open Temperature and humidity readings from the Shelly H&T Gen3 are updated unpredictably. Affects: Shelly H&T Gen3
- open Controlling multiple channels on the Shelly RGBW2 device does not work as expected. Affects: Shelly RGBW2
- open A warning appears related to the IP address of the Shelly Relais device. Affects: Shelly Relais
- open Reported problem #179044
Fixed
- fixed in 2026.11.0 Bug fix #189255
- fixed in 2026.10.1 Uncalibrated Shelly RPC covers now report their last known direction correctly. Affects: Shelly RPC
- fixed in 2026.10.0 Configuration setup stops if the Shelly device is not compatible with Home Assistant.
- fixed in 2026.9.0 Uncalibrated Shelly roller devices now report their last known direction accurately. Affects: Shelly roller
- fixed in 2026.9.0 Shelly devices using enhanced security now work properly with HTTP connections.
- fixed in 2026.8.3 A specific error related to floor heating mode on the LinkedGo ST802 is resolved. Affects: LinkedGo ST802
- fixed in 2026.8.3 The Shelly Wall Display status now handles cases where no errors are present. Affects: Shelly Wall Display
- fixed in 2026.6.2 Virtual components on Shelly devices now retrieve their units correctly.
- fixed in 2026.6.2 Home Assistant waits for the Shelly Bluetooth proxy connection during startup. Affects: Shelly Bluetooth proxy
- fixed in 2026.6.0 Shelly sensors now restore their state properly even if they were not initialized.
- fixed in 2026.6.0 Home Assistant skips repair checks for Shelly RPC devices that are not ready. Affects: Shelly RPC
- fixed in 2026.5.4 Media player images are now validated correctly with proper MIME types. Affects: Shelly media player
Source: the issue tracker of Home Assistant, as of November 2, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.