diff --git a/source/_components/input_boolean.markdown b/source/_components/input_boolean.markdown
index 2e66c928787..57a0f2c1aab 100644
--- a/source/_components/input_boolean.markdown
+++ b/source/_components/input_boolean.markdown
@@ -11,16 +11,22 @@ logo: home-assistant.png
 ha_category: Automation
 ---
 
-The input boolean component allows the user to define boolean values that can be controlled via the frontend and can be used within conditions of automation. This can for example be used to disable or enable certain automations.
+The `input_boolean` component allows the user to define boolean values that can be controlled via the frontend and can be used within conditions of automation. This can for example be used to disable or enable certain automations.
 
 ```yaml
 # Example configuration.yaml entry
 input_boolean:
   notify_home:
-    # Optional, friendly name of entry
     name: Notify when someome arrives home
-    # Optional, value when Home Assistant starts
     initial: off
-    # Optional, icon for entry
     icon: mdi:car
 ```
+
+Configuration variables:
+
+- **name** (*Optional*): Friendly name of entry.
+- **initial** (*Optional*): Initial value when Home Assistant starts.
+- **icon** (*Optional*): Icon for entry.
+
+Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or  `mdi:motorbike`.
+