diff --git a/source/_components/media_player.itunes.markdown b/source/_components/media_player.itunes.markdown
index cced6a1953a..717307250a2 100644
--- a/source/_components/media_player.itunes.markdown
+++ b/source/_components/media_player.itunes.markdown
@@ -14,9 +14,11 @@ ha_iot_class: "Local Polling"
 ---
 
 
-The iTunes platform allows you to control [iTunes](http://apple.com/itunes/) from Home Assistant. It uses a 3rd party server that you run on your Mac called [itunes-api](https://github.com/maddox/itunes-api). Play, pause, or skip songs remotely on iTunes running on your Mac.
+The `itunes` media player platform allows you to control [iTunes](http://apple.com/itunes/) from Home Assistant. It uses a 3rd party server that you run on your Mac called [itunes-api](https://github.com/maddox/itunes-api). Play, pause or skip songs remotely on iTunes running on your Mac.
 
-In addition to controlling iTunes, your available AirPlay endpoints will be added as media players as well. You can then individually address them and turn them on, turn them off, or adjust their volume.
+In addition to controlling iTunes, your available AirPlay endpoints will be added as media players as well. You can then individually address them and turn them on, turn them off or adjust their volume.
+
+## {% linkable_title Configuration %}
 
 To add iTunes to your installation, add the following to your `configuration.yaml` file:
 
@@ -27,7 +29,14 @@ media_player:
     host: 192.168.1.50
 ```
 
-Configuration variables:
-
-- **host** (*Required*): The IP of the itunes-api API, eg. 192.168.1.50
-- **port** (*Optional*): The port where itunes-api is accessible, eg. 8181.
+{% configuration %}
+host:
+  description: The IP of the itunes-api API, e.g., 192.168.1.50.
+  required: true
+  type: string
+port:
+  description: The port where itunes-api is accessible, e.g., 8181.
+  required: false
+  default: 8181
+  type: integer
+{% endconfiguration %}