diff --git a/docs/card-media.md b/docs/card-media.md
index d0a6e970..099a48a9 100644
--- a/docs/card-media.md
+++ b/docs/card-media.md
@@ -15,5 +15,32 @@ key | optional | type | default | description
`type` | False | string | `None` | Used by navigate items
`title` | True | string | `None` | Title of the Page
`entity` | False | string | `None` | contains the entity of the current card
+`entities` | False | complex | `None` | contains a list of entities shown in the bottom row, supports all entities supported by cardGrid
`key` | True | string | `None` | Used by navigate items
-`mediaControl` | True | complex | `None` | overwrites the action executed on pressing the left upper icon (red circle), icon is showing the current type of media and cannot be changed (configure it to a navigate entity; see subpages for more details `navigate.cardGrid_key`)
+
+
+Example with configured Entities
+
+```
+ - type: cardMedia
+ title: Kitchen
+ entity: media_player.kitchen
+ entities:
+ - entity: light.bed_light
+ - entity: light.ceiling_lights
+ - entity: light.entrance_color_white_lights
+ - entity: light.kitchen_lights
+ - entity: light.living_room_rgbww_lights
+```
+
+
+
+Example with action on upper left media icon
+
+```
+ - type: cardMedia
+ title: Kitchen
+ entity: input_select.test123
+ status: media_player.kitchen
+```
+
diff --git a/docs/img/card-media.png b/docs/img/card-media.png
index 34849b6c..fba8cd30 100644
Binary files a/docs/img/card-media.png and b/docs/img/card-media.png differ