diff --git a/source/_components/sensor.twitch.markdown b/source/_components/sensor.twitch.markdown
index d1265c1b1d5..660488a7675 100644
--- a/source/_components/sensor.twitch.markdown
+++ b/source/_components/sensor.twitch.markdown
@@ -16,6 +16,10 @@ ha_iot_class: "Cloud Polling"
 
 The `twitch` platform will allow you to monitor [Twitch](http://www.twitch.tv/) channel status from within Home Assistant and setup automation based on the information.
 
+## {% linkable_title Setup %}
+
+Create a new app at "Register Your Application" in the [Twitch developer portal](https://glass.twitch.tv/console/apps). Then get the **Client ID** for the new app.
+
 ## {% linkable_title Configuration %}
 
 To use Twitch with your installation, add the following to your `configuration.yaml` file:
@@ -24,12 +28,17 @@ To use Twitch with your installation, add the following to your `configuration.y
 # Example configuration.yaml entry
 sensor:
   platform: twitch
+  client_id: YOUR_TWITCH_CLIENT_ID
   channels:
     - channel1
     - channel2
 ```
 
 {% configuration %}
+clientid:
+  description: Your Twitch client ID.
+  required: true
+  type: string
 channels:
   description: List of channels.
   required: true