diff --git a/source/components/media_player.kodi.markdown b/source/components/media_player.kodi.markdown
index 644e1aa1dbe..a0c8251edb4 100644
--- a/source/components/media_player.kodi.markdown
+++ b/source/components/media_player.kodi.markdown
@@ -18,9 +18,15 @@ To add Kodi to your installation, add the following to your `configuration.yaml`
 # Example configuration.yaml entry
 media_player:
   platform: kodi
-  name: Kodi
   url: http://192.168.0.123/jsonrpc
-  user: kodi
-  password: my_secure_password
+  name: Kodi
+  user: USERNAME
+  password: PASSWORD
 ```
 
+Configuration variables:
+
+- **url** *Required*: The URL of the XBMC/Kodi JSON-RPC API, eg. http://192.168.0.123/jsonrpc
+- **name** *Optional*: The name of the device used in the frontend.
+- **username** *Optional*: The XBMC/Kodi HTTP username.
+- **password** *Optional*: The XBMC/Kodi HTTP password.