diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown
new file mode 100644
index 00000000000..87cb86509b3
--- /dev/null
+++ b/source/_integrations/shelly.markdown
@@ -0,0 +1,24 @@
+---
+title: Shelly
+description: Integrate Shelly devices
+ha_category:
+  - Switch
+ha_release: 0.115
+ha_codeowners:
+  - "@balloob"
+ha_domain: shelly
+---
+
+Integrate [Shelly devices](https://shelly.cloud) into Home Assistant.
+
+## Configuration
+
+To add a Shelly device to your installation, go to **Configuration** >> **Integrations** in the UI. Devices will be automatically discovered when on the same network and listed on the integrations page. Click on "Configure" of the discovered device to add it to Home Assistant.
+
+A device can also be added manually, click the button with `+` sign on the integrations page and from the list of integrations, select **Shelly** and follow the instructions shown.
+
+## Known issues and limitations
+
+- Only supports firmware 1.8 and later
+- Support relays, lights (brightness) and sensors
+- Shelly 2.5 in roller mode is not supported