From db2d6acbb5a1ffe4103f29140c7345d5c0d00e37 Mon Sep 17 00:00:00 2001
From: Andrew Sayre <6730289+andrewsayre@users.noreply.github.com>
Date: Wed, 26 Mar 2025 14:56:44 +0000
Subject: [PATCH] Document play queue

---
 source/_integrations/heos.markdown | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/source/_integrations/heos.markdown b/source/_integrations/heos.markdown
index 4c358912588..8e4728e415f 100644
--- a/source/_integrations/heos.markdown
+++ b/source/_integrations/heos.markdown
@@ -178,6 +178,25 @@ data:
 | `media_content_type`   | no       | Set to the value `url`                           |
 | `media_content_id`     | no       | The full URL to the stream (max 255 characters)  |
 
+#### Play a queue item
+
+You can play/move to an item within the player's queue by using the `media_player.play_media` action. Set `media_content_type` to `queue` and `media_content_id` to the index (starting from 1) of an item in the play queue.
+The play queue can be enumerated by using the `heos.get_queue` service. Example action data payload:
+
+```yaml
+action: media_player.play_media
+data:
+  entity_id: media_player.office
+  media_content_type: "queue"
+  media_content_id: "1"
+```
+
+| Data attribute | Optional | Description                   |
+| ---------------------- | -------- | ----------------------------- |
+| `entity_id`            | yes      | `entity_id` of the player(s)  |
+| `media_content_type`   | no       | Set to the value `queue`   |
+| `media_content_id`     | no       | The queue index (e.g. `1`) |
+
 ### Grouping players
 
 #### Join