diff --git a/source/_components/switch.mqtt.markdown b/source/_components/switch.mqtt.markdown
index ca62ceb039d..252d8f9de5d 100644
--- a/source/_components/switch.mqtt.markdown
+++ b/source/_components/switch.mqtt.markdown
@@ -54,12 +54,12 @@ state_on:
   description: The payload that represents the on state.
   required: false
   type: string
-  default: "ON"
+  default: "`payload_on` if defined, else ON"
 state_off:
   description: The payload that represents the off state.
   required: false
   type: string
-  default: "OFF"
+  default: "`payload_off` if defined, else OFF"
 availability_topic:
   description: The MQTT topic subscribed to receive availability (online/offline) updates.
   required: false