Migrating Sonos.join to media_player.join

I have HA 2021.12.10 installed. I am looking to upgrade to 2022.8.3

There is a Sonos breaking change in 2022.8 as described below:

“The sonos.join and sonos.unjoin services will be removed in 2022.8 in favor of the standard media_player.join and media_player.unjoin services.”

I cannot find any guidance on how to join Sonos speakers using the media_player.join

Below is an example script for the Sonos.join


  • service: sonos.join
    master: media_player.sonos_garage
    entity_id: media_player.sonos_den
  • service: sonos.join
    master: media_player.sonos_garage
    entity_id: media_player.living_room
    : single
    alias: Sonos Join Example`

What is the media_player.join equivalent example?


service: media_player.join
  entity_id: media_player.sonos_garage
    - media_player.sonos_den
    - media_player.living_room
1 Like

Thanks, your post was helpful as it gave me the confidence to push the update button
After I migrated, to HA 22.8, I discovered the UI input box for medi_player.join was enhanced for grouping and the new process seamlessly joined the sonos entities. The code was identical to your example, and all was good with this part of the HA 22.8 update.

You’re welcome!

Please consider marking my post above with the Solution tag. It will automatically place a check-mark next to the topic’s title which signals to other users that this topic has been resolved. This helps users find answers to similar questions.

For more information, refer to guideline 21 in the FAQ.

Why am I getting this then? Stopped because an error was encountered at November 6, 2022 at 8:39:09 AM (runtime: 0.01 seconds)

Entity media_player.garage_2 does not support this service.

Post your automation.


I am new to Homeassistant and have really enjoyed looking at the forums.

I have been using SmartThings and my Sonos system was recognised and it works.

Unfortunately in Home Assistant, when I “migrated” devices from SmartThings, are listed as a device but not recognised when I added the Sonos integration.

Can anyone help?



I get a no devices found on the network when setting up the Sonos.

Sorry - my Docker contwiner is set to bridge - maybe that is the reason? If yes, how do you switch to host mode?

If you are in bridge mode, you need to specify the ip addresses of the speakers in configuration.yaml. The documentation describes how to do that.

How to switch from bridge to host mode is a docker question.