Sonos in Home Assistant
sonos
part of Home Assistant since 0.7.3
Sonos is an official Home Assistant integration for Media player and Sensor. 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
- Hub – several devices through one gateway or account
- Quality scale
- Bronze – The basic requirements for a new integration are met.
- Installations
- 88,042 (12.9 % of the installations that share statistics)
- Categories
- Media player, Sensor
- Provides
- Binary sensor, Button, Diagnostics, Media player, Number, Select, Sensor, Switch
- Found automatically via
- Network discovery (Zeroconf), Network discovery (SSDP)
- Maintained by
- @peterager, @jjlawren
- Python packages
defusedxml==0.7.1, soco==0.31.2, sonos-websocket==0.2.0
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 Sonos.
- 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
- Script Text-to-Speech on Sonos
- Automation Group Sonos on Motion
- Automation Group Sonos on Motion
- Automation Sonos Connect Sync
- Automation Clear Paused Sonos Queue
- Automation Phlips Tap Dial Sonos Controller
Known issues and fixes
12 open issues and 31 bug fixes in the last twelve months are recorded for Sonos in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.8.3.
Open
- open Reported problem #88714
- open Reported problem #170773
- open Reported problem #170551
- open Reported problem #176962
- open Reported problem #163345
- open Reported problem #181804
- open Reported problem #170348
- open Reported problem #178021
Fixed
- fixed in 2026.8.3 Bug fix #177510
- fixed in 2026.7.2 Bug fix #176109
- fixed in 2026.6.4 Bug fix #174231
- fixed in 2026.6.0 Bug fix #172614
- fixed in 2026.4.1 Bug fix #167303
- fixed in 2026.4.1 Bug fix #167223
- fixed in 2026.1.0 Bug fix #160011
- fixed in 2025.12.5 Bug fix #159330
- fixed in 2025.12.4 Bug fix #158764
- fixed in 2025.12.4 Bug fix #159106
- fixed in 2025.12.4 Bug fix #159108
- fixed in 2025.10.0 Bug fix #152491
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
