Back to the overview

Shelly in Home Assistant

shelly part of Home Assistant since 0.115

Local, push Set up in the user interface Quality: Platinum

Shelly is an official Home Assistant integration for Binary sensor, Camera, Climate, Cover, Energy, Event, Light, Media player, Number, Select, Sensor, Switch, Text, Update and Valve. Talks to the device on your own network and is told about every change straight away.

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
136,248 (19.9 % 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==13.33.0

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Shelly.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

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 ♥ 15 · Import · Forum
  • Automation Shelly Button1 press ♥ 5 · Import · Forum
  • Automation Shelly Detached Input - Single Button v1.3.1 ♥ 3 · Import · Forum
  • Automation Shelly Plus 1 Button actions ♥ 2 · Import · Forum

All blueprints for it

Community versions in HACS

These extensions use the same domain. Installed through HACS, one of them takes the place of the official integration – usually to bring a feature or a fix sooner. Remove it again once Home Assistant has caught up.

  • HACS ShellyForHass (Shelly integration) – Shelly smart home platform for Home Assistant updated March 8, 2025 · Open in HACS · GitHub

Known issues and fixes

29 open issues and 68 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.9.0.

Open

  • open Reported problem #177277 since July 26, 2026 · 19 reactions · 46 comments · #177277
  • open Reported problem #177257 Affects: Shelly 2PM Gen3 since July 26, 2026 · 18 reactions · 78 comments · #177257
  • open Reported problem #178360 since August 6, 2026 · 7 reactions · 16 comments · #178360
  • open Reported problem #174098 since June 17, 2026 · 3 reactions · 4 comments · #174098
  • open Reported problem #131308 Affects: Shelly Plus Smoke since November 22, 2024 · 1 reaction · 41 comments · #131308
  • open Reported problem #170327 since May 11, 2026 · 1 reaction · 15 comments · #170327
  • open Reported problem #177011 since July 21, 2026 · 1 reaction · 2 comments · #177011
  • open Reported problem #177670 since July 30, 2026 · 0 reactions · 13 comments · #177670

Fixed

Source: the issue tracker of Home Assistant, as of September 13, 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

Scroll to Top