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
- 92,278 (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.5, 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 – Plays text-to-speech on Sonos speakers. Requires a Sonos media player.
- Automation Group Sonos on Motion – Triggers Sonos media players on motion detection, using Sonos integration.
- Automation Group Sonos on Motion – Triggers Sonos speakers on motion detection, needing Sonos integration.
- Automation Sonos Connect Sync
- Automation Clear Paused Sonos Queue – Clears a paused Sonos media player queue when triggered.
- Automation Phlips Tap Dial Sonos Controller
Known issues and fixes
13 open issues and 29 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 #181804
- open Reported problem #170551
- open Reported problem #176962
- open Reported problem #163345
- open Reported problem #170348
- open Reported problem #178021
- open Reported problem #168908
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
Source: the issue tracker of Home Assistant, as of October 26, 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
