diff --git a/source/_components/media_extractor.markdown b/source/_components/media_extractor.markdown
index 812a00f2e17..82e4b9c1206 100644
--- a/source/_components/media_extractor.markdown
+++ b/source/_components/media_extractor.markdown
@@ -13,7 +13,10 @@ ha_release: 0.49
 ---
 
 
-The `media_extractor` component gets an stream URL and send it to a media player entity.
+The `media_extractor` component gets an stream URL and send it to a media player entity. This component can extract entity specific streams if configured accordingly.
+<p class='note'>
+Media extractor doesn't transcode streams, it just tries to find stream that match requested query.
+</p>
 
 To use the media extrator service in your installation, add the following to your `configuration.yaml` file:
 
@@ -22,9 +25,35 @@ To use the media extrator service in your installation, add the following to you
 media_extractor:
 ```
 
+Configuration variables:
+
+- **default_query** (*Optional*): Set default stream query for all devices ('best' by default).
+- **customize** (*Optional*): Set entity specific values. For example:
+
+```yaml
+# Example configuration.yaml entry
+media_extractor:
+  default_query: worst
+  customize:
+    media_player.my_sonos:
+      video: bestvideo
+      music: bestaudio[ext=mp3]
+```
+
+This configuration sets query for all service calls like: ```{"entity_id": "media_player.my_sonos", "media_content_id": "https://soundcloud.com/bruttoband/brutto-11", "media_content_type": "music"}``` to 'bestaudio' with mp3 extention.
+
+Query examples with explanations:
+ * **bestvideo** - best video only stream
+ * **best** - best video + audio stream
+ * **bestaudio[ext=m4a]** - best audio stream with m4a extension
+ * **worst** - worst video + audio stream
+ * **bestaudio[ext=m4a]/bestaudio[ext=ogg]/bestaudio** - best m4a audio, otherwise best ogg audio and only then any best audio
+
+More info about queries [here](https://github.com/rg3/youtube-dl#format-selection)
+
 ### {% linkable_title Use the service %}
 
-Go the the "Developer Tools", then to "Call Service", and choose `media_extractor/play_media` from the list of available services. Fill the "Service Data" field as shown in the example below and hit "CALL SERVICE".
+Go to the "Developer Tools", then to "Call Service", and choose `media_extractor/play_media` from the list of available services. Fill the "Service Data" field as shown in the example below and hit "CALL SERVICE".
 
 This will download the file from the given URL.