diff --git a/source/_components/switch.rachio.markdown b/source/_components/switch.rachio.markdown
new file mode 100644
index 00000000000..e75c4ed155e
--- /dev/null
+++ b/source/_components/switch.rachio.markdown
@@ -0,0 +1,85 @@
+---
+layout: page
+title: "Rachio Switch"
+description: "Instructions how to use Rachio switches with Home Assistant."
+date: 2017-05-29 09:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: rachio.png
+ha_category: Switch
+ha_iot_class: "Local Polling"
+ha_release: 0.46
+---
+
+The `rachio` switch platform allows you to control your [Rachio irrigations system](http://rachio.com/).
+
+## {% linkable_title Getting your Rachio API Access Token %}
+
+- Log in at [https://app.rach.io/](https://app.rach.io/).
+- Click the user button at the top right.
+- Click API Access Token.
+- Copy the API access token from the dialog that opens.
+
+To add this platform to your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+switch:
+  - platform: rachio
+    access_token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+```
+
+Configuration variables:
+
+- **access_token** (*Required3): Your Rachio API Access Token.
+- **manual_run_mins** (*Optional*): For how long, in minutes, to turn on a station when the switch is enabled. Defaults to 10 minutes.
+
+## {% linkable_title Examples %}
+
+In this section you find some real life examples of how to use this switch.
+
+### {% linkable_title `groups.yaml` example %}
+
+
+```yaml
+irrigation:
+  name: Irrigation
+  icon: mdi:water-pump
+  view: true
+  entities:
+  - group.zones_front
+  - group.zones_back
+
+zones_front:
+  name: Front Yard
+  view: false
+  entities:
+  - switch.driveway
+  - switch.front_bushes
+  - switch.front_garden
+  - switch.front_yard
+  - switch.side_yard
+
+zones_back:
+  name: Back Yard
+  view: false
+  entities:
+  - switch.back_bushes
+  - switch.back_garden
+  - switch.back_porch
+  - switch.back_trees
+```
+
+### {% linkable_title iFrame %}
+
+If you would like to see the Rachio details then create an [iFrame](/components/panel_iframe/) that contains the information accessible through your panel.
+
+```yaml
+panel_iframe:
+  rachio:
+    title: Rachio
+    url: "https://app.rach.io"
+    icon: mdi:water-pump
+```
diff --git a/source/images/supported_brands/rachio.png b/source/images/supported_brands/rachio.png
new file mode 100644
index 00000000000..340105ff824
Binary files /dev/null and b/source/images/supported_brands/rachio.png differ