diff --git a/source/components/switch.transmission.markdown b/source/components/switch.transmission.markdown
index e482b013f67..a8b9267fc35 100644
--- a/source/components/switch.transmission.markdown
+++ b/source/components/switch.transmission.markdown
@@ -18,11 +18,18 @@ To add Transmission to your installation, add the following to your `configurati
 # Example configuration.yaml entry
 switch:
   platform: transmission
-  name: Transmission
   host: 192.168.1.26
   port: 9091
-  username: YOUR_USERNAME
-  password: YOUR_PASSWORD
+  name: Transmission
+  username: USERNAME
+  password: PASSWORD
 ```
 
-[Finbarr Brady](https://github.com/fbradyirl) has contributed the transmission switch platform.
+Configuration variables:
+
+- **host** (*Required*): This is the IP address of your Transmission daemon, e.g. 192.168.1.32.
+- **port** (*Optional*): The port your Transmission daemon uses, defaults to 9091.
+- **name** (*Optional*): The name to use when displaying this Transmission instance.
+- **username** (*Required*): Your Transmission username, if you use authentication.
+- **password** (*Required*): Your Transmission password, if you use authentication.
+