diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown
index 516658404a6..8889e29fbc8 100644
--- a/source/_components/qwikswitch.markdown
+++ b/source/_components/qwikswitch.markdown
@@ -60,13 +60,32 @@ On some QS Mobile servers button events are only generated for switches added to
 
 ### {% linkable_title Qwikswitch Sensors %}
 
-Some Qwikswith devices might support more than one channel per device (i.e. ipmod). The channel can be specified by appending a number to the QS_id. Example sensors configuration:
+The sensor configuration is a list of sensors. Each sensor is configured with the following parameters:
+
+- **name** (*Required*): The sensor name from which the entity_id will be derived.
+- **id** (*Required*): A QS_Id
+- **type** (*Required*): The Qwikswitch sensor type. These could include:
+   - imod (up to 6 channels)
+   - door (single channel)
+   - qwikcord (Channel1 = CTavg, Channel 2 = CTsum)
+- **channel** (*Optional, default=1*): The channel of interest. Refer to type above.
+
+
+Example sensor configuration:
 
 ```yaml
 qwikswitch:
   ...
   sensors:
-    door_sensor: '@0dev01'
-    door2_sensor: '@0dev02.1'
-    door3_sensor: '@0dev02.2'
+    - name: door sensor
+      id: "@id03"
+      type: door
+    - name: Imod 1 sensor
+      id: "@id02"
+      channel: 1
+      type: imod
+    - name: Imod 2 sensor
+      id: "@id02"
+      channel: 2
+      type: imod
 ```