Add config block to media selector

balloob · balloob · commit 00d72c9c36ae · 2025-06-24T16:59:06.000Z
diff --git a/source/_docs/blueprint/selectors.markdown b/source/_docs/blueprint/selectors.markdown
@@ -52,6 +52,7 @@ The following selectors are currently available:
 - [Theme selector](#theme-selector)
 - [Time selector](#time-selector)
 - [Trigger selector](#trigger-selector)
+  - [Example - Merging with existing triggers](#example---merging-with-existing-triggers)
 
 Interactive demos of each of these selectors can be found on the
 [Home Assistant Design portal](https://design.home-assistant.io/#components/ha-selector).
@@ -1029,17 +1030,30 @@ You are prompted to select the device used to play media. Once the device is sel
 
 ![Screenshot of the Media selector](/images/blueprints/selector-media.png)
 
+To ask the user to select a media device and suitable media, you can use the
+media selector without any options:
+
 ```yaml
 media:
 ```
 
+You can also use the media selector with an optional `accept` filter to limit the
+media types that can be selected. The user will not be asked to pick a device.
+
 ```yaml
-# Do not ask for a device but manually specify a filter for the media.
 media:
   accept:
     - image/*
 ```
 
+{% configuration area %}
+accept:
+  description: >
+    List of media types the user is allowed to select.
+  type: list
+  required: false
+{% endconfiguration %}
+
 The output of the media selector, is an mapping with information about
 the selected media device and the selected media to play. There is also
 metadata, which is used by the frontend and should not be used in the
@@ -1181,7 +1195,7 @@ object:
   fields:
     name:
       label: Name
-      selector: 
+      selector:
         text:
     percentage:
       label: Percentage
